API Classes

ADOAPI Class

API to interact with Andromeda ADOs.

export default class ADOAPI {
  constructor(
    protected client: AndromedaClient,
    protected address: string = ""
  ) {}

Execute Messages

andromedaReceive

Converts a message object to an Andromeda Execute message.

 protected andromedaReceive(msg: Msg) {
    return { andr_receive: msg };
  }

Name	Type	Description
msg	Msg	The message to convert.

Msg

export type Msg = Record<string, unknown>

updateOwnerMsg

Returns an update owner message.

updateOwnerMsg(newOwner: string) {
    return this.andromedaReceive({ update_owner: { address: newOwner } });
  }

Name	Type	Description
newOwner	string	The address to assign as the new owner.

updateOwner

Updates the owner for the given ADO.

Only accessible to the current owner.

async updateOwner(
    newOwner: string,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.updateOwnerMsg(newOwner);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
newOwner	string	The address of the new owner.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee attached.
memo	string	Optional memo to attached.

Fee

export type Fee = number | StdFee | "auto"

Check StdFee.

updateOperatorsMsg

Returns an update operators message.

updateOperatorsMsg(operators: string[]) {
    return this.andromedaReceive({ update_operators: { operators } });
  }

Name	Type	Description
operators	string[]	An array of strings containing the addresses to make operators.

updateOperators

Updates the operators for a given ADO.

Only accessible to the current owner.

async updateOperators(
    operators: string[],
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.updateOperatorsMsg(operators);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
operators	string[]	An array of strings containing the addresses to make operators.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

updateAppContractMsg

Returns an update app contract message.

updateAppContractMsg(appContract: string) {
    return this.andromedaReceive({
      update_app_contract: { address: appContract },
    });
  }

Name	Type	Description
appContract	string	The new app contract.

updateAppContract

Updates the app contract for a given ADO.

Only accessible to the current owner.

async updateAppContract(
    appContract: string,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.updateAppContractMsg(appContract);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
appContract	string	The new app contract.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

registerModuleMsg

Returns a register module message.

  registerModuleMsg(module: Module) {
    return this.andromedaReceive({ register_module: { module } });
  }

Name	Type	Description
module	Module	The module to register.

Module

export interface Module {
  module_type: string;
  address: AndrAddress;
  is_mutable: boolean;
}

Name	Type	Description
module_type	string	The ADO type for the module.
address	AndrAddress	The address of the module.
is_mutable	boolean	Whether the module is mutable.

AndrAddress

An interface used to reference another ADO contract. Can be either an address or identifier of an ADO in an app.

export interface AndrAddress {
  identifier: string;
}

registerModule

Register a module with an ADO.

Only accessible by the contract owner.

Will error if the ADO does not implement modules.

  async registerModule(
    module: Module,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.registerModuleMsg(module);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
module	Module	The module to register.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

deregisterModuleMsg

Returns a deregister module message.

  deregisterModuleMsg(id: number) {
    return this.andromedaReceive({ deregister_module: { module_idx: id } });
  }

Name	Type	Description
id	number	The id number (index) of the module to deregister.

deregisterModule

Deregisters a module with an ADO.

Only accessible by the contract owner.

Will error if the ADO does not implement modules.

 async deregisterModule(
    id: number,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.deregisterModuleMsg(id);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
id	number	The id number (index) of the module to deregister.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

alterModuleMsg

Returns am alter module message.

 alterModuleMsg(id: number, module: Module) {
    return this.andromedaReceive({ alter_module: { module, module_idx: id } });
  }

Name	Type	Description
id	number	The id number (index) of the module to alter.
module	Module	The new module to replace the old one.

alterModule

Alters a module within an ADO.

Only accessible by the contract owner.

Will error if the ADO does not implement modules.

  async alterModule(
    id: number,
    module: Module,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.alterModuleMsg(id, module);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
id	number	The id number (index) of the module to alter.
module	Module	The new module to replace the old one.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

refreshAddressMsg

Returns a refresh address message.

 refreshAddressMsg(key: string) {
    return this.andromedaReceive({ refresh_address: { address: key } });
  }

Name	Type	Description
key	string	The key to refresh the address for.

refreshAddress

Refreshes any AndrAddresses within the ADO for the specified key. This is used when we have saved addresses in a primitve and want to update the cashe in case they change.

Only accessible by the contract owner.

async refreshAddress(
    key: string,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.refreshAddressMsg(key);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
key	string	The key to refresh the address for.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach.
memo	string	Optional memo to attach.

refreshAddressesMsg

Returns a refresh addresses message.

  refreshAddressesMsg(startAfter?: string, limit?: number) {
    return this.andromedaReceive({
      refresh_addresses: { start_after: startAfter, limit },
    });
  }

Name	Type	Description
startAfter	string	An optional key for which to start after, used for pagination.
limit	number	An optional limit to the number of addresses to refresh. Defaults to 10. The max limit is 20.

refreshAddresses

Refreshes multiple addresses.

Only accessible by the contract owner

 async refreshAddresses(
    startAfter?: string,
    limit?: number,
    addr: string = this.address,
    fee?: Fee,
    memo?: string
  ) {
    const msg = this.refreshAddressesMsg(startAfter, limit);
    const resp = await this.client.execute(addr, msg, fee, memo);

    return resp;
  }

Name	Type	Description
startAfter	string	An optional key for which to start after, used for pagination.
limit	number	An optional limit to the number of addresses to refresh. Defaults to 10. The max limit is 20.
addr	string	The address of the contract we are executing on.
fee	Fee	Optional fee to attach
memo	string	Optional memo to attach.

Query Messages

andromedaQuery

Converts a message object to an Andromeda Query message.

  protected andromedaQuery(msg: Msg) {
    return { andr_query: msg };
  }

Name	Type	Description
msg	Msg	The query message.

operatorsQuery

Returns an operators query message.

  operatorsQuery() {
    return this.andromedaQuery({ operators: [] });
  }

getOperators

Gets all operators for the provided ADO.

  async getOperators(addr: string = this.address) {
    const query = this.operatorsQuery();
    const resp = await this.client.queryContract<{ operators: string[] }>(
      addr,
      query
    );

    return resp.operators;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

ownerQuery

Returns an owner query message.

 ownerQuery() {
    return this.andromedaQuery({ owner: {} });
  }

getOwner

Gets the owner address for a provided ADO.

async getOwner(addr: string = this.address) {
    const query = this.ownerQuery();
    const resp = await this.client.queryContract<{ owner: string }>(
      addr,
      query
    );
    return resp.owner;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

isOperatorOrOwner

Validates if a given address is an owner or operator for the given ADO.

  async isOperatorOrOwner(addr: string, contractAddr: string = this.address) {
    const operators = await this.getOperators(contractAddr);
    const owner = await this.getOwner(contractAddr);
    return operators.includes(addr) || owner === addr;
  }

Name	Type	Description
addr	string	The address we are checking.
contractAddr	string	The address of the contract we are querying.

typeQuery

Returns an ADO type query message.

  typeQuery() {
    return this.andromedaQuery({ type: {} });
  }

getType

Gets the ADO type for the provided ADO.

 async getType(addr: string = this.address) {
    const query = this.typeQuery();
    const resp = await this.client.queryContract<{ ado_type: string }>(
      addr,
      query
    );

    return resp.ado_type;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

publisherQuery

  publisherQuery() {
    return this.andromedaQuery({ original_publisher: {} });
  }

getPublisher

Gets the original publisher of the given ADO.

  async getPublisher(addr: string = this.address) {
    const query = this.publisherQuery();
    const resp = await this.client.queryContract<{
      original_publisher: string;
    }>(addr, query);

    return resp.original_publisher;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

createdHeightQuery

Returns a block height creation query.

  createdHeightQuery() {
    return this.andromedaQuery({ block_height_upon_creation: {} });
  }

getCreatedHeight

Gets the block height at which the given ADO was created.

 async getCreatedHeight(addr: string = this.address) {
    const query = this.createdHeightQuery();
    const resp = await this.client.queryContract<{ block_height: number }>(
      addr,
      query
    );

    return resp.block_height;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

versionQuery

Returns a version query.

  versionQuery() {
    return this.andromedaQuery({ version: {} });
  }

getVersion

Gets the version for a given ADO.

  async getVersion(addr: string = this.address) {
    const query = this.versionQuery();
    const resp = await this.client.queryContract<{ version: string }>(
      addr,
      query
    );

    return resp.version;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

moduleQuery

Returns a module query.

  moduleQuery(id: string | number) {
    return this.andromedaQuery({ module: { id } });
  }

Name	Type	Description
id	string or number	The id of the module to query.

getModule

Gets the module of the specified id for a given ADO.

Will error if the ADO does not implement modules.

  async getModule(id: string | number, addr: string = this.address) {
    const query = this.moduleQuery(id);
    const resp = await this.client.queryContract<Module>(addr, query);

    return resp;
  }

Name	Type	Description
id	string or number	The id of the module to query.
addr	string	The address of the contract we are querying.

moduleIdsQuery

Returns a module IDs query.

  moduleIdsQuery() {
    return this.andromedaQuery({ module_ids: {} });
  }

getModuleIds

Gets all module IDs for a given ADO.

Will error if the ADO does not implement modules

  async getModuleIds(addr: string = this.address) {
    const query = this.moduleIdsQuery();
    const resp = await this.client.queryContract<string[]>(addr, query);

    return resp;
  }

Name	Type	Description
addr	string	The address of the contract we are querying.

getModules

Gets all modules for a given ADO.

Uses several queries so response may be slow.

  async getModules(addr: string = this.address) {
    const ids = await this.getModuleIds(addr);
    const modulePromises = [];

    for (let i = 0; i < ids.length; i++) {
      modulePromises.push(this.getModule(ids[i], addr));
    }

    const modules = await Promise.all(modulePromises);

    return modules;
  }
}

Name	Type	Description
addr	string	The address of the contract we are querying.