algosdk 2.9.0 → 3.0.0-beta.1

package/dist/types/client/v2/indexer/searchAccounts.d.ts

@@ -1,4 +1,7 @@
-import JSONRequest from '../jsonrequest';
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClientResponse } from '../../client.js';
+import { Address } from '../../../encoding/address.js';
+import { AccountsResponse } from './models/types.js';
 /**
  * Returns information about indexed accounts.
  *
@@ -10,7 +13,7 @@ import JSONRequest from '../jsonrequest';
  * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2accounts)
  * @category GET
  */
-export default class SearchAccounts extends JSONRequest {
+export default class SearchAccounts extends JSONRequest<AccountsResponse> {
     /**
      * @returns `/v2/accounts`
      */
@@ -156,7 +159,7 @@ export default class SearchAccounts extends JSONRequest {
      *
      * @param authAddr
      */
-    authAddr(authAddr: string): this;
+    authAddr(authAddr: string | Address): this;
     /**
      * Filter for this application.
      *
@@ -221,4 +224,5 @@ export default class SearchAccounts extends JSONRequest {
      * @category query
      */
     exclude(exclude: string): this;
+    prepare(response: HTTPClientResponse): AccountsResponse;
 }

package/dist/types/client/v2/indexer/searchForApplicationBoxes.d.ts

@@ -1,8 +1,7 @@
-import JSONRequest from '../jsonrequest';
-import HTTPClient from '../../client';
-import IntDecoding from '../../../types/intDecoding';
-import { BoxesResponse } from './models/types';
-export default class SearchForApplicationBoxes extends JSONRequest<BoxesResponse, Record<string, any>> {
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClient, HTTPClientResponse } from '../../client.js';
+import { BoxesResponse } from './models/types.js';
+export default class SearchForApplicationBoxes extends JSONRequest<BoxesResponse> {
     private index;
     /**
      * Returns information about indexed application boxes.
@@ -30,7 +29,7 @@ export default class SearchForApplicationBoxes extends JSONRequest<BoxesResponse
      * @oaram index - application index.
      * @category GET
      */
-    constructor(c: HTTPClient, intDecoding: IntDecoding, index: number);
+    constructor(c: HTTPClient, index: number);
     /**
      * @returns `/v2/applications/${index}/boxes`
      */
@@ -76,5 +75,5 @@ export default class SearchForApplicationBoxes extends JSONRequest<BoxesResponse
      * @category query
      */
     limit(limit: number): this;
-    prepare(body: Record<string, any>): BoxesResponse;
+    prepare(response: HTTPClientResponse): BoxesResponse;
 }

package/dist/types/client/v2/indexer/searchForApplications.d.ts

@@ -1,4 +1,7 @@
-import JSONRequest from '../jsonrequest';
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClientResponse } from '../../client.js';
+import { Address } from '../../../encoding/address.js';
+import { ApplicationsResponse } from './models/types.js';
 /**
  * Returns information about indexed applications.
  *
@@ -10,7 +13,7 @@ import JSONRequest from '../jsonrequest';
  * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2applications)
  * @category GET
  */
-export default class SearchForApplications extends JSONRequest {
+export default class SearchForApplications extends JSONRequest<ApplicationsResponse> {
     /**
      * @returns `/v2/applications`
      */
@@ -45,7 +48,7 @@ export default class SearchForApplications extends JSONRequest {
      * @param creator
      * @category query
      */
-    creator(creator: string): this;
+    creator(creator: string | Address): this;
     /**
      * Specify the next page of results.
      *
@@ -107,4 +110,5 @@ export default class SearchForApplications extends JSONRequest {
      * @category query
      */
     includeAll(value?: boolean): this;
+    prepare(response: HTTPClientResponse): ApplicationsResponse;
 }

package/dist/types/client/v2/indexer/searchForAssets.d.ts

@@ -1,4 +1,7 @@
-import JSONRequest from '../jsonrequest';
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClientResponse } from '../../client.js';
+import { Address } from '../../../encoding/address.js';
+import { AssetsResponse } from './models/types.js';
 /**
  * Returns information about indexed assets.
  *
@@ -10,7 +13,7 @@ import JSONRequest from '../jsonrequest';
  * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2assets)
  * @category GET
  */
-export default class SearchForAssets extends JSONRequest {
+export default class SearchForAssets extends JSONRequest<AssetsResponse> {
     /**
      * @returns `/v2/assets`
      */
@@ -46,7 +49,7 @@ export default class SearchForAssets extends JSONRequest {
      * @param creator
      * @category query
      */
-    creator(creator: string): this;
+    creator(creator: string | Address): this;
     /**
      * Filter just assets with the given name.
      *
@@ -140,4 +143,5 @@ export default class SearchForAssets extends JSONRequest {
      * @category query
      */
     includeAll(value?: boolean): this;
+    prepare(response: HTTPClientResponse): AssetsResponse;
 }

package/dist/types/client/v2/indexer/searchForTransactions.d.ts

@@ -1,4 +1,7 @@
-import JSONRequest from '../jsonrequest';
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClientResponse } from '../../client.js';
+import { Address } from '../../../encoding/address.js';
+import { TransactionsResponse } from './models/types.js';
 /**
  * Returns information about indexed transactions.
  *
@@ -10,7 +13,7 @@ import JSONRequest from '../jsonrequest';
  * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2transactions)
  * @category GET
  */
-export default class SearchForTransactions extends JSONRequest {
+export default class SearchForTransactions extends JSONRequest<TransactionsResponse> {
     /**
      * @returns `/v2/transactions`
      */
@@ -172,10 +175,10 @@ export default class SearchForTransactions extends JSONRequest {
      *        .do();
      * ```
      *
-     * @param before - rfc3339 string
+     * @param before - rfc3339 string or Date object
      * @category query
      */
-    beforeTime(before: string): this;
+    beforeTime(before: string | Date): this;
     /**
      * Include results after the given time.
      *
@@ -188,10 +191,10 @@ export default class SearchForTransactions extends JSONRequest {
      *        .do();
      * ```
      *
-     * @param after - rfc3339 string
+     * @param after - rfc3339 string or Date object
      * @category query
      */
-    afterTime(after: string): this;
+    afterTime(after: string | Date): this;
     /**
      * Combined with address, defines what address to filter on, as string.
      *
@@ -225,7 +228,7 @@ export default class SearchForTransactions extends JSONRequest {
      * @param address
      * @category query
      */
-    address(address: string): this;
+    address(address: string | Address): this;
     /**
      * Whether or not to consider the `close-to` field as a receiver when filtering transactions, as bool. Set to `true` to ignore `close-to`.
      *
@@ -349,4 +352,5 @@ export default class SearchForTransactions extends JSONRequest {
      * @category query
      */
     currencyLessThan(lesser: number): this;
+    prepare(response: HTTPClientResponse): TransactionsResponse;
 }

package/dist/types/client/v2/jsonrequest.d.ts

@@ -1,5 +1,4 @@
-import HTTPClient from '../client';
-import IntDecoding from '../../types/intDecoding';
+import { HTTPClient, HTTPClientResponse } from '../client.js';
 /**
  * Base abstract class for JSON requests.
  *
@@ -7,17 +6,13 @@ import IntDecoding from '../../types/intDecoding';
  *
  * Body: The structure of the response's body
  */
-export default abstract class JSONRequest<Data = Record<string, any>, Body = Data | Uint8Array> {
+export default abstract class JSONRequest<Data> {
     c: HTTPClient;
     query: Record<string, any>;
-    intDecoding: IntDecoding;
     /**
      * @param client - HTTPClient object.
-     * @param intDecoding - The method to use
-     *   for decoding integers from this request's response. See the setIntDecoding method for more
-     *   details.
      */
-    constructor(client: HTTPClient, intDecoding?: IntDecoding);
+    constructor(client: HTTPClient);
     /**
      * @returns The path of this request.
      * @category JSONRequest
@@ -26,41 +21,33 @@ export default abstract class JSONRequest<Data = Record<string, any>, Body = Dat
     /**
      * Prepare a JSON response before returning it.
      *
-     * Use this method to change and restructure response
-     * data as needed after receiving it from the `do()` method.
-     * @param body - Response body received
+     * Use this method to unpack response ata as needed after receiving it from the `do()` method.
+     * @param response - Response body received
      * @category JSONRequest
      */
-    prepare(body: Body): Data;
+    abstract prepare(response: HTTPClientResponse): Data;
     /**
-     * Execute the request.
+     * Execute the request
+     */
+    protected executeRequest(headers?: Record<string, string>, customOptions?: Record<string, unknown>): Promise<HTTPClientResponse>;
+    /**
+     * Execute the request and decode the response.
      * @param headers - Additional headers to send in the request. Optional.
-     * @returns A promise which resolves to the parsed response data.
+     * @param customOptions - Additional options to pass to the underlying BaseHTTPClient. For
+     *   {@link URLTokenBaseHTTPClient}, which is the default client, this will be treated as
+     *   additional options to pass to the network `fetch` method.
+     * @returns A promise which resolves to the parsed response object.
      * @category JSONRequest
      */
-    do(headers?: Record<string, any>): Promise<Data>;
+    do(headers?: Record<string, string>, customOptions?: Record<string, unknown>): Promise<Data>;
     /**
      * Execute the request, but do not process the response data in any way.
      * @param headers - Additional headers to send in the request. Optional.
+     * @param customOptions - Additional options to pass to the underlying BaseHTTPClient. For
+     *   {@link URLTokenBaseHTTPClient}, which is the default client, this will be treated as
+     *   additional options to pass to the network `fetch` method.
      * @returns A promise which resolves to the raw response data, exactly as returned by the server.
      * @category JSONRequest
      */
-    doRaw(headers?: Record<string, any>): Promise<Uint8Array>;
-    /**
-     * Configure how integers in this request's JSON response will be decoded.
-     *
-     * The options are:
-     * * "default": Integers will be decoded according to JSON.parse, meaning they will all be
-     *   Numbers and any values greater than Number.MAX_SAFE_INTEGER will lose precision.
-     * * "safe": All integers will be decoded as Numbers, but if any values are greater than
-     *   Number.MAX_SAFE_INTEGER an error will be thrown.
-     * * "mixed": Integers will be decoded as Numbers if they are less than or equal to
-     *   Number.MAX_SAFE_INTEGER, otherwise they will be decoded as BigInts.
-     * * "bigint": All integers will be decoded as BigInts.
-     *
-     * @param method - The method to use when parsing the
-     *   response for this request. Must be one of "default", "safe", "mixed", or "bigint".
-     * @category JSONRequest
-     */
-    setIntDecoding(method: IntDecoding): this;
+    doRaw(headers?: Record<string, string>, customOptions?: Record<string, unknown>): Promise<Uint8Array>;
 }

package/dist/types/client/v2/serviceClient.d.ts

@@ -1,26 +1,12 @@
-import HTTPClient from '../client';
-import IntDecoding from '../../types/intDecoding';
-import { BaseHTTPClient } from '../baseHTTPClient';
-import { TokenHeader } from '../urlTokenBaseHTTPClient';
-export declare type TokenHeaderIdentifier = 'X-Indexer-API-Token' | 'X-KMD-API-Token' | 'X-Algo-API-Token' | string;
+import { HTTPClient } from '../client.js';
+import { BaseHTTPClient } from '../baseHTTPClient.js';
+import { TokenHeader } from '../urlTokenBaseHTTPClient.js';
+export type TokenHeaderIdentifier = 'X-Indexer-API-Token' | 'X-KMD-API-Token' | 'X-Algo-API-Token' | string;
 /**
  * Abstract service client to encapsulate shared AlgodClient and IndexerClient logic
  */
 export default abstract class ServiceClient {
     /** @ignore */
     c: HTTPClient;
-    /** @ignore */
-    intDecoding: IntDecoding;
     constructor(tokenHeaderIdentifier: TokenHeaderIdentifier, tokenHeaderOrStrOrBaseClient: string | TokenHeader | BaseHTTPClient, baseServer: string, port?: string | number, defaultHeaders?: Record<string, any>);
-    /**
-     * Set the default int decoding method for all JSON requests this client creates.
-     * @param method - \{"default" | "safe" | "mixed" | "bigint"\} method The method to use when parsing the
-     *   response for request. Must be one of "default", "safe", "mixed", or "bigint". See
-     *   JSONRequest.setIntDecoding for more details about what each method does.
-     */
-    setIntEncoding(method: IntDecoding): void;
-    /**
-     * Get the default int decoding method for all JSON requests this client creates.
-     */
-    getIntEncoding(): IntDecoding;
 }

package/dist/types/client/v2/untypedmodel.d.ts

@@ -0,0 +1,10 @@
+import { Encodable, MsgpackEncodingData } from '../../encoding/encoding.js';
+import { UntypedSchema } from '../../encoding/schema/index.js';
+export declare class UntypedValue implements Encodable {
+    static readonly encodingSchema: UntypedSchema;
+    readonly data: MsgpackEncodingData;
+    constructor(data: MsgpackEncodingData);
+    getEncodingSchema(): UntypedSchema;
+    toEncodingData(): MsgpackEncodingData;
+    static fromEncodingData(data: unknown): UntypedValue;
+}

package/dist/types/composer.d.ts

@@ -1,9 +1,10 @@
-import { ABIMethod, ABIValue } from './abi';
-import Algodv2 from './client/v2/algod/algod';
-import { SimulateResponse, SimulateRequest } from './client/v2/algod/models/types';
-import { TransactionSigner, TransactionWithSigner } from './signer';
-import { BoxReference, OnApplicationComplete, SuggestedParams } from './types/transactions/base';
-export declare type ABIArgument = ABIValue | TransactionWithSigner;
+import { ABIMethod, ABIValue } from './abi/index.js';
+import { AlgodClient } from './client/v2/algod/algod.js';
+import { SimulateRequest, PendingTransactionResponse, SimulateResponse } from './client/v2/algod/models/types.js';
+import { Address } from './encoding/address.js';
+import { TransactionSigner, TransactionWithSigner } from './signer.js';
+import { BoxReference, OnApplicationComplete, SuggestedParams } from './types/transactions/base.js';
+export type ABIArgument = ABIValue | TransactionWithSigner;
 /** Represents the output from a successful ABI method call. */
 export interface ABIResult {
     /** The TxID of the transaction that invoked the ABI method call. */
@@ -25,7 +26,7 @@ export interface ABIResult {
     /** If the SDK was unable to decode a return value, the error will be here. */
     decodeError?: Error;
     /** The pending transaction information from the method transaction */
-    txInfo?: Record<string, any>;
+    txInfo?: PendingTransactionResponse;
 }
 export declare enum AtomicTransactionComposerStatus {
     /** The atomic group is still under construction. */
@@ -77,13 +78,13 @@ export declare class AtomicTransactionComposer {
      */
     addMethodCall({ appID, method, methodArgs, sender, suggestedParams, onComplete, approvalProgram, clearProgram, numGlobalInts, numGlobalByteSlices, numLocalInts, numLocalByteSlices, extraPages, appAccounts, appForeignApps, appForeignAssets, boxes, note, lease, rekeyTo, signer, }: {
         /** The ID of the smart contract to call. Set this to 0 to indicate an application creation call. */
-        appID: number;
+        appID: number | bigint;
         /** The method to call on the smart contract */
         method: ABIMethod;
         /** The arguments to include in the method call. If omitted, no arguments will be passed to the method. */
         methodArgs?: ABIArgument[];
         /** The address of the sender of this application call */
-        sender: string;
+        sender: string | Address;
         /** Transactions params to use for this application call */
         suggestedParams: SuggestedParams;
         /** The OnComplete action to take for this application call. If omitted, OnApplicationComplete.NoOpOC will be used. */
@@ -103,11 +104,11 @@ export declare class AtomicTransactionComposer {
         /** The number of extra pages to allocate for the application's programs. Only set this if this is an application creation call. If omitted, defaults to 0. */
         extraPages?: number;
         /** Array of Address strings that represent external accounts supplied to this application. If accounts are provided here, the accounts specified in the method args will appear after these. */
-        appAccounts?: string[];
+        appAccounts?: Array<string | Address>;
         /** Array of App ID numbers that represent external apps supplied to this application. If apps are provided here, the apps specified in the method args will appear after these. */
-        appForeignApps?: number[];
+        appForeignApps?: Array<number | bigint>;
         /** Array of Asset ID numbers that represent external assets supplied to this application. If assets are provided here, the assets specified in the method args will appear after these. */
-        appForeignAssets?: number[];
+        appForeignAssets?: Array<number | bigint>;
         /** The box references for this application call */
         boxes?: BoxReference[];
         /** The note value for this application call */
@@ -115,7 +116,7 @@ export declare class AtomicTransactionComposer {
         /** The lease value for this application call */
         lease?: Uint8Array;
         /** If provided, the address that the sender will be rekeyed to at the conclusion of this application call */
-        rekeyTo?: string;
+        rekeyTo?: string | Address;
         /** A transaction signer that can authorize this application call from sender */
         signer: TransactionSigner;
     }): void;
@@ -149,7 +150,7 @@ export declare class AtomicTransactionComposer {
      *
      * @returns A promise that, upon success, resolves to a list of TxIDs of the submitted transactions.
      */
-    submit(client: Algodv2): Promise<string[]>;
+    submit(client: AlgodClient): Promise<string[]>;
     /**
      * Simulates the transaction group in the network.
      *
@@ -166,7 +167,7 @@ export declare class AtomicTransactionComposer {
      *   array of results containing one element for each method call transaction
      *   in this group (ABIResult[]) and the SimulateResponse object.
      */
-    simulate(client: Algodv2, request?: SimulateRequest): Promise<{
+    simulate(client: AlgodClient, request?: SimulateRequest): Promise<{
         methodResults: ABIResult[];
         simulateResponse: SimulateResponse;
     }>;
@@ -187,7 +188,7 @@ export declare class AtomicTransactionComposer {
      *   this transaction, the txIDs of the submitted transactions, and an array of results containing
      *   one element for each method call transaction in this group.
      */
-    execute(client: Algodv2, waitRounds: number): Promise<{
+    execute(client: AlgodClient, waitRounds: number): Promise<{
         confirmedRound: number;
         txIDs: string[];
         methodResults: ABIResult[];
@@ -200,5 +201,5 @@ export declare class AtomicTransactionComposer {
      * @param pendingInfo
      * @returns An ABIResult object
      */
-    static parseMethodResponse(method: ABIMethod, methodResult: ABIResult, pendingInfo: Record<string, any>): ABIResult;
+    static parseMethodResponse(method: ABIMethod, methodResult: ABIResult, pendingInfo: PendingTransactionResponse): ABIResult;
 }

package/dist/types/dryrun.d.ts

@@ -1,6 +1,6 @@
-import AlgodClient from './client/v2/algod/algod';
-import { AccountStateDelta, DryrunRequest, DryrunSource, EvalDeltaKeyValue, TealValue } from './client/v2/algod/models/types';
-import { SignedTransaction } from './transaction';
+import { AlgodClient } from './client/v2/algod/algod.js';
+import { DryrunRequest, DryrunSource, DryrunTxnResult } from './client/v2/algod/models/types.js';
+import { SignedTransaction } from './signedTransaction.js';
 /**
  * createDryrun takes an Algod Client (from algod.AlgodV2Client) and an array of Signed Transactions
  * from (transaction.SignedTransaction) and creates a DryrunRequest object with relevant balances
@@ -8,6 +8,8 @@ import { SignedTransaction } from './transaction';
  * @param txns - the array of SignedTransaction to use for generating the DryrunRequest object
  * @param protocolVersion - the string representing the protocol version to use
  * @param latestTimestamp - the timestamp
+ * @param round - the round available to some TEAL scripts. Defaults to the current round on the network.
+ * @param sources - TEAL source text that gets uploaded, compiled, and inserted into transactions or application state.
  * @returns the DryrunRequest object constructed from the SignedTransactions passed
  */
 export declare function createDryrun({ client, txns, protocolVersion, latestTimestamp, round, sources, }: {
@@ -18,83 +20,9 @@ export declare function createDryrun({ client, txns, protocolVersion, latestTime
     round?: number | bigint;
     sources?: DryrunSource[];
 }): Promise<DryrunRequest>;
-interface StackValueResponse {
-    type: number;
-    bytes: string;
-    uint: number;
-}
-declare class DryrunStackValue {
-    type: number;
-    bytes: string;
-    uint: number;
-    constructor(sv: StackValueResponse);
-    toString(): string;
-}
-interface DryrunTraceLineResponse {
-    error: string;
-    line: number;
-    pc: number;
-    scratch: TealValue[];
-    stack: StackValueResponse[];
-}
-declare class DryrunTraceLine {
-    error: string;
-    line: number;
-    pc: number;
-    scratch: TealValue[];
-    stack: DryrunStackValue[];
-    constructor(line: DryrunTraceLineResponse);
-}
-declare class DryrunTrace {
-    trace: DryrunTraceLine[];
-    constructor(t: DryrunTraceLineResponse[]);
-}
-interface DryrunTransactionResultResponse {
-    disassembly: string[];
-    appCallMessages: string[] | undefined;
-    localDeltas: AccountStateDelta[] | undefined;
-    globalDelta: EvalDeltaKeyValue[] | undefined;
-    cost: number | undefined;
-    logicSigMessages: string[] | undefined;
-    logicSigDisassembly: string[] | undefined;
-    logs: string[] | undefined;
-    appCallTrace: DryrunTrace | undefined;
-    logicSigTrace: DryrunTrace | undefined;
-}
-interface StackPrinterConfig {
+export interface StackPrinterConfig {
     maxValueWidth: number | undefined;
     topOfStackFirst: boolean | undefined;
 }
-declare class DryrunTransactionResult {
-    disassembly: string[];
-    appCallMessages: string[] | undefined;
-    localDeltas: AccountStateDelta[] | undefined;
-    globalDelta: EvalDeltaKeyValue[] | undefined;
-    cost: number | undefined;
-    logicSigMessages: string[] | undefined;
-    logicSigDisassembly: string[] | undefined;
-    logs: string[] | undefined;
-    appCallTrace: DryrunTrace | undefined;
-    logicSigTrace: DryrunTrace | undefined;
-    required: string[];
-    optionals: string[];
-    traces: string[];
-    constructor(dtr: DryrunTransactionResultResponse);
-    appCallRejected(): boolean;
-    logicSigRejected(): boolean;
-    static trace(drt: DryrunTrace, disassembly: string[], spc: StackPrinterConfig): string;
-    appTrace(spc?: StackPrinterConfig): string;
-    lsigTrace(spc?: StackPrinterConfig): string;
-}
-interface DryrunResultResponse {
-    ['error']: string;
-    ['protocol-version']: string;
-    ['txns']: DryrunTransactionResultResponse[];
-}
-export declare class DryrunResult {
-    error: string;
-    protocolVersion: string;
-    txns: DryrunTransactionResult[];
-    constructor(drrResp: DryrunResultResponse);
-}
-export {};
+export declare function dryrunTxnResultAppTrace(result: DryrunTxnResult, spc?: StackPrinterConfig): string;
+export declare function dryrunTxnResultLogicSigTrace(result: DryrunTxnResult, spc?: StackPrinterConfig): string;

package/dist/types/encoding/address.d.ts

@@ -1,12 +1,45 @@
-import { Address } from '../types/address';
-import { MultisigMetadata } from '../types/multisig';
+export declare const ALGORAND_ADDRESS_BYTE_LENGTH = 36;
+export declare const ALGORAND_CHECKSUM_BYTE_LENGTH = 4;
+export declare const ALGORAND_ADDRESS_LENGTH = 58;
 export declare const ALGORAND_ZERO_ADDRESS_STRING = "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAY5HFKQ";
 export declare const MALFORMED_ADDRESS_ERROR_MSG = "address seems to be malformed";
 export declare const CHECKSUM_ADDRESS_ERROR_MSG = "wrong checksum for address";
-export declare const INVALID_MSIG_VERSION_ERROR_MSG = "invalid multisig version";
-export declare const INVALID_MSIG_THRESHOLD_ERROR_MSG = "bad multisig threshold";
-export declare const INVALID_MSIG_PK_ERROR_MSG = "bad multisig public key - wrong length";
-export declare const UNEXPECTED_PK_LEN_ERROR_MSG = "nacl public key length is not 32 bytes";
+/**
+ * Represents an Algorand address
+ */
+export declare class Address {
+    /**
+     * The binary form of the address. For standard accounts, this is the public key.
+     */
+    readonly publicKey: Uint8Array;
+    /**
+     * Create a new Address object from its binary form.
+     * @param publicKey - The binary form of the address. Must be 32 bytes.
+     */
+    constructor(publicKey: Uint8Array);
+    /**
+     * Check if the address is equal to another address.
+     */
+    equals(other: Address): boolean;
+    /**
+     * Compute the 4 byte checksum of the address.
+     */
+    checksum(): Uint8Array;
+    /**
+     * Encode the address into a string form.
+     */
+    toString(): string;
+    /**
+     * Decode an address from a string.
+     * @param address - The address to decode. Must be 58 bytes long.
+     * @returns An Address object corresponding to the input string.
+     */
+    static fromString(address: string): Address;
+    /**
+     * Get the zero address.
+     */
+    static zeroAddress(): Address;
+}
 /**
  * decodeAddress takes an Algorand address in string form and decodes it into a Uint8Array.
  * @param address - an Algorand address with checksum.
@@ -25,33 +58,9 @@ export declare function isValidAddress(address: string): boolean;
  * @returns the address and checksum encoded as a string.
  */
 export declare function encodeAddress(address: Uint8Array): string;
-/**
- * fromMultisigPreImg takes multisig parameters and returns a 32 byte typed array public key,
- * representing an address that identifies the "exact group, version, and public keys" that are required for signing.
- * Hash("MultisigAddr" || version uint8 || threshold uint8 || PK1 || PK2 || ...)
- * Encoding this output yields a human readable address.
- * @param version - multisig version
- * @param threshold - multisig threshold
- * @param pks - array of typed array public keys
- */
-export declare function fromMultisigPreImg({ version, threshold, pks, }: Omit<MultisigMetadata, 'addrs'> & {
-    pks: Uint8Array[];
-}): Uint8Array;
-/**
- * fromMultisigPreImgAddrs takes multisig parameters and returns a human readable Algorand address.
- * This is equivalent to fromMultisigPreImg, but interfaces with encoded addresses.
- * @param version - multisig version
- * @param threshold - multisig threshold
- * @param addrs - array of encoded addresses
- */
-export declare function fromMultisigPreImgAddrs({ version, threshold, addrs, }: {
-    version: number;
-    threshold: number;
-    addrs: string[];
-}): string;
 /**
  * Get the escrow address of an application.
  * @param appID - The ID of the application.
  * @returns The address corresponding to that application's escrow account.
  */
-export declare function getApplicationAddress(appID: number | bigint): string;
+export declare function getApplicationAddress(appID: number | bigint): Address;

package/dist/types/encoding/binarydata.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Convert a base64 string to a Uint8Array for Node.js and browser environments.
+ * @returns A Uint8Array
+ */
+export declare function base64ToBytes(base64String: string): Uint8Array;
+/**
+ * Convert a Uint8Array to a base64 string for Node.js and browser environments.
+ * @returns A base64 string
+ */
+export declare function bytesToBase64(byteArray: Uint8Array): string;
+/**
+ * Convert a byte array to a UTF-8 string. Warning: not all byte arrays are valid UTF-8.
+ * @returns A decoded string
+ */
+export declare function bytesToString(byteArray: Uint8Array): string;
+/**
+ * Returns a Uint8Array given an input string or Uint8Array.
+ * @returns A base64 string
+ */
+export declare function coerceToBytes(input: Uint8Array | string): Uint8Array;
+/**
+ * Convert a Uint8Array to a hex string for Node.js and browser environments.
+ * @returns A hex string
+ */
+export declare function bytesToHex(byteArray: Uint8Array): string;
+/**
+ * Convert a hex string to Uint8Array for Node.js and browser environments.
+ * @returns A Uint8Array
+ */
+export declare function hexToBytes(hexString: string): Uint8Array;