@digitalworld/digital-world-sdk 16.0.0

package/lib/esm/federation/server.d.ts

@@ -0,0 +1,116 @@
+import type { Api } from "./api.js";
+/**
+ * The maximum size of response from a federation server
+ * @defaultValue 102400
+ */
+export declare const FEDERATION_RESPONSE_MAX_SIZE: number;
+/**
+ * Federation.Server handles a network connection to a
+ * [federation server](https://docs.digitalworld.global/docs/learn/encyclopedia/federation)
+ * instance and exposes an interface for requests to that instance.
+ *
+ * @param serverURL - The federation server URL (ex. `https://acme.com/federation`).
+ * @param domain - Domain this server represents
+ * @param opts - (optional) Options object
+ * @returns  */
+export declare class FederationServer {
+    /**
+     * The federation server URL (ex. `https://acme.com/federation`).
+     */
+    private readonly serverURL;
+    /**
+     * Domain this server represents.
+     */
+    private readonly domain;
+    /**
+     * Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.
+     */
+    private readonly timeout;
+    /**
+     * A helper method for handling user inputs that contain `destination` value.
+     * It accepts two types of values:
+     *
+     * * For Digital World address (ex. `bob*digitalworld.global`) it splits Digital World address and then tries to find information about
+     * federation server in `dw.toml` file for a given domain. It returns a `Promise` which resolves if federation
+     * server exists and user has been found and rejects in all other cases.
+     * * For Account ID (ex. `GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS`) it returns a `Promise` which
+     * resolves if Account ID is valid and rejects in all other cases. Please note that this method does not check
+     * if the account actually exists in a ledger.
+     *
+     * @example
+     * ```ts
+     * DigitalWorldSdk.FederationServer.resolve('bob*digitalworld.global')
+     *  .then(federationRecord => {
+     *    // {
+     *    //   account_id: 'GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS',
+     *    //   memo_type: 'id',
+     *    //   memo: 100
+     *    // }
+     *  });
+     * ```
+     *
+     * @see <a href="https://docs.digitalworld.global/docs/learn/encyclopedia/federation" target="_blank">Federation doc</a>
+     * @see <a href="https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info" target="_blank">dw.toml doc</a>
+     * @param value - Digital World Address (ex. `bob*digitalworld.global`)
+     * @param opts - (optional) Options object
+     * @returns A promise that resolves to the federation record
+     * @throws Will throw an error if the provided account ID is not a valid Ed25519 public key.
+     */
+    static resolve(value: string, opts?: Api.Options): Promise<Api.Record>;
+    /**
+     * Creates a `FederationServer` instance based on information from
+     * [dw.toml](https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info)
+     * file for a given domain.
+     *
+     * If `dw.toml` file does not exist for a given domain or it does not
+     * contain information about a federation server Promise will reject.
+     *
+     * @example
+     * ```ts
+     * DigitalWorldSdk.FederationServer.createForDomain('acme.com')
+     *   .then(federationServer => {
+     *     // federationServer.resolveAddress('bob').then(...)
+     *   })
+     *   .catch(error => {
+     *     // dw.toml does not exist or it does not contain information about federation server.
+     *   });
+     * ```
+     *
+     * @see <a href="https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info" target="_blank">dw.toml doc</a>
+     * @param domain - Domain to get federation server for
+     * @param opts - (optional) Options object
+     * @returns A promise that resolves to the federation record
+     * @throws Will throw an error if the domain's dw.toml file does not contain a federation server field.
+     */
+    static createForDomain(domain: string, opts?: Api.Options): Promise<FederationServer>;
+    constructor(serverURL: string, domain: string, opts?: Api.Options);
+    /**
+     * Get the federation record if the user was found for a given Digital World address
+     * @see <a href="https://docs.digitalworld.global/docs/encyclopedia/federation" target="_blank">Federation doc</a>
+     * @param address - Digital World address (ex. `bob*digitalworld.global`). If `FederationServer` was instantiated with `domain` param only username (ex. `bob`) can be passed.
+     * @returns A promise that resolves to the federation record
+     * @throws Will throw an error if the federated address does not contain a domain, or if the server object was not instantiated with a `domain` parameter
+     */
+    resolveAddress(address: string): Promise<Api.Record>;
+    /**
+     * Given an account ID, get their federation record if the user was found
+     * @see <a href="https://docs.digitalworld.global/docs/encyclopedia/federation" target="_blank">Federation doc</a>
+     * @param accountId - Account ID (ex. `GBYNR2QJXLBCBTRN44MRORCMI4YO7FZPFBCNOKTOBCAAFC7KC3LNPRYS`)
+     * @returns A promise that resolves to the federation record
+     * @throws Will throw an error if the federation server returns an invalid memo value.
+     * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+     * @throws Will throw an error if the server query fails with an improper response.
+     */
+    resolveAccountId(accountId: string): Promise<Api.Record>;
+    /**
+     * Given a transactionId, get the federation record if the sender of the transaction was found
+     * @see <a href="https://docs.digitalworld.global/docs/glossary/federation/" target="_blank">Federation doc</a>
+     * @param transactionId - Transaction ID (ex. `3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889`)
+     * @returns A promise that resolves to the federation record
+     * @throws Will throw an error if the federation server returns an invalid memo value.
+     * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+     * @throws Will throw an error if the server query fails with an improper response.
+     */
+    resolveTransactionId(transactionId: string): Promise<Api.Record>;
+    private _sendRequest;
+}

package/lib/esm/federation/server.js

@@ -0,0 +1,226 @@
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
+import 'buffer';
+import '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import '../base/keypair.js';
+import { StrKey } from '../base/strkey.js';
+import '../base/util/continued_fraction.js';
+import '../base/util/bignumber.js';
+import '../base/transaction_builder.js';
+import '../base/muxed_account.js';
+import '../base/scval.js';
+import '../base/numbers/uint128.js';
+import '../base/numbers/uint256.js';
+import '../base/numbers/int128.js';
+import '../base/numbers/int256.js';
+import { Config } from '../config.js';
+import { BadResponseError } from '../errors/bad_response.js';
+import { Resolver } from '../dwtoml/index.js';
+import { validateDomain } from './utils.js';
+import { fetchClient } from '../http-client/fetch-client.js';
+
+const FEDERATION_RESPONSE_MAX_SIZE = 100 * 1024;
+class FederationServer {
+  /**
+   * The federation server URL (ex. `https://acme.com/federation`).
+   */
+  serverURL;
+  // TODO: public or private? readonly?
+  /**
+   * Domain this server represents.
+   */
+  domain;
+  // TODO: public or private? readonly?
+  /**
+   * Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.
+   */
+  timeout;
+  // TODO: public or private? readonly?
+  /**
+   * A helper method for handling user inputs that contain `destination` value.
+   * It accepts two types of values:
+   *
+   * * For Digital World address (ex. `bob*digitalworld.global`) it splits Digital World address and then tries to find information about
+   * federation server in `dw.toml` file for a given domain. It returns a `Promise` which resolves if federation
+   * server exists and user has been found and rejects in all other cases.
+   * * For Account ID (ex. `GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS`) it returns a `Promise` which
+   * resolves if Account ID is valid and rejects in all other cases. Please note that this method does not check
+   * if the account actually exists in a ledger.
+   *
+   * @example
+   * ```ts
+   * DigitalWorldSdk.FederationServer.resolve('bob*digitalworld.global')
+   *  .then(federationRecord => {
+   *    // {
+   *    //   account_id: 'GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS',
+   *    //   memo_type: 'id',
+   *    //   memo: 100
+   *    // }
+   *  });
+   * ```
+   *
+   * @see <a href="https://docs.digitalworld.global/docs/learn/encyclopedia/federation" target="_blank">Federation doc</a>
+   * @see <a href="https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info" target="_blank">dw.toml doc</a>
+   * @param value - Digital World Address (ex. `bob*digitalworld.global`)
+   * @param opts - (optional) Options object
+   * @returns A promise that resolves to the federation record
+   * @throws Will throw an error if the provided account ID is not a valid Ed25519 public key.
+   */
+  static async resolve(value, opts = {}) {
+    if (value.indexOf("*") < 0) {
+      if (!StrKey.isValidEd25519PublicKey(value)) {
+        return Promise.reject(new Error("Invalid Account ID"));
+      }
+      return Promise.resolve({ account_id: value });
+    }
+    const addressParts = value.split("*");
+    const [, domain] = addressParts;
+    if (addressParts.length !== 2 || !domain) {
+      return Promise.reject(new Error("Invalid Digital World address"));
+    }
+    const federationServer = await FederationServer.createForDomain(
+      domain,
+      opts
+    );
+    return federationServer.resolveAddress(value);
+  }
+  /**
+   * Creates a `FederationServer` instance based on information from
+   * [dw.toml](https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info)
+   * file for a given domain.
+   *
+   * If `dw.toml` file does not exist for a given domain or it does not
+   * contain information about a federation server Promise will reject.
+   *
+   * @example
+   * ```ts
+   * DigitalWorldSdk.FederationServer.createForDomain('acme.com')
+   *   .then(federationServer => {
+   *     // federationServer.resolveAddress('bob').then(...)
+   *   })
+   *   .catch(error => {
+   *     // dw.toml does not exist or it does not contain information about federation server.
+   *   });
+   * ```
+   *
+   * @see <a href="https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info" target="_blank">dw.toml doc</a>
+   * @param domain - Domain to get federation server for
+   * @param opts - (optional) Options object
+   * @returns A promise that resolves to the federation record
+   * @throws Will throw an error if the domain's dw.toml file does not contain a federation server field.
+   */
+  static async createForDomain(domain, opts = {}) {
+    validateDomain(domain);
+    const tomlObject = await Resolver.resolve(domain, opts);
+    if (!tomlObject.FEDERATION_SERVER) {
+      return Promise.reject(
+        new Error("dw.toml does not contain FEDERATION_SERVER field")
+      );
+    }
+    return new FederationServer(tomlObject.FEDERATION_SERVER, domain, opts);
+  }
+  constructor(serverURL, domain, opts = {}) {
+    this.serverURL = new URL(serverURL);
+    this.domain = domain;
+    validateDomain(domain);
+    const allowHttp = typeof opts.allowHttp === "undefined" ? Config.isAllowHttp() : opts.allowHttp;
+    this.timeout = typeof opts.timeout === "undefined" ? Config.getTimeout() : opts.timeout;
+    if (this.serverURL.protocol !== "https:" && !allowHttp) {
+      throw new Error("Cannot connect to insecure federation server");
+    }
+  }
+  /**
+   * Get the federation record if the user was found for a given Digital World address
+   * @see <a href="https://docs.digitalworld.global/docs/encyclopedia/federation" target="_blank">Federation doc</a>
+   * @param address - Digital World address (ex. `bob*digitalworld.global`). If `FederationServer` was instantiated with `domain` param only username (ex. `bob`) can be passed.
+   * @returns A promise that resolves to the federation record
+   * @throws Will throw an error if the federated address does not contain a domain, or if the server object was not instantiated with a `domain` parameter
+   */
+  async resolveAddress(address) {
+    let stellarAddress = address;
+    if (address.indexOf("*") < 0) {
+      if (!this.domain) {
+        return Promise.reject(
+          new Error(
+            "Unknown domain. Make sure `address` contains a domain (ex. `bob*digitalworld.global`) or pass `domain` parameter when instantiating the server object."
+          )
+        );
+      }
+      stellarAddress = `${address}*${this.domain}`;
+    }
+    const url = new URL(this.serverURL);
+    url.search = "";
+    url.searchParams.set("type", "name");
+    url.searchParams.set("q", stellarAddress);
+    return this._sendRequest(url);
+  }
+  /**
+   * Given an account ID, get their federation record if the user was found
+   * @see <a href="https://docs.digitalworld.global/docs/encyclopedia/federation" target="_blank">Federation doc</a>
+   * @param accountId - Account ID (ex. `GBYNR2QJXLBCBTRN44MRORCMI4YO7FZPFBCNOKTOBCAAFC7KC3LNPRYS`)
+   * @returns A promise that resolves to the federation record
+   * @throws Will throw an error if the federation server returns an invalid memo value.
+   * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+   * @throws Will throw an error if the server query fails with an improper response.
+   */
+  async resolveAccountId(accountId) {
+    const url = new URL(this.serverURL);
+    url.search = "";
+    url.searchParams.set("type", "id");
+    url.searchParams.set("q", accountId);
+    return this._sendRequest(url);
+  }
+  /**
+   * Given a transactionId, get the federation record if the sender of the transaction was found
+   * @see <a href="https://docs.digitalworld.global/docs/glossary/federation/" target="_blank">Federation doc</a>
+   * @param transactionId - Transaction ID (ex. `3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889`)
+   * @returns A promise that resolves to the federation record
+   * @throws Will throw an error if the federation server returns an invalid memo value.
+   * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+   * @throws Will throw an error if the server query fails with an improper response.
+   */
+  async resolveTransactionId(transactionId) {
+    const url = new URL(this.serverURL);
+    url.search = "";
+    url.searchParams.set("type", "txid");
+    url.searchParams.set("q", transactionId);
+    return this._sendRequest(url);
+  }
+  async _sendRequest(url) {
+    const timeout = this.timeout;
+    return fetchClient.get(url.toString(), {
+      maxContentLength: FEDERATION_RESPONSE_MAX_SIZE,
+      timeout
+    }).then((response) => {
+      if (typeof response.data.memo !== "undefined" && typeof response.data.memo !== "string") {
+        throw new Error("memo value should be of type string");
+      }
+      return response.data;
+    }).catch((response) => {
+      if (response instanceof Error) {
+        if (response.message.match(/^maxContentLength size/)) {
+          throw new Error(
+            `federation response exceeds allowed size of ${FEDERATION_RESPONSE_MAX_SIZE}`
+          );
+        } else {
+          return Promise.reject(response);
+        }
+      } else {
+        return Promise.reject(
+          new BadResponseError(
+            `Server query failed. Server responded: ${response.status} ${response.statusText}`,
+            response.data
+          )
+        );
+      }
+    });
+  }
+}
+
+export { FEDERATION_RESPONSE_MAX_SIZE, FederationServer };
+//# sourceMappingURL=server.js.map

package/lib/esm/federation/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sources":["../../../src/federation/server.ts"],"sourcesContent":["import { StrKey } from \"../base/index.js\";\n\nimport { Config } from \"../config.js\";\nimport { BadResponseError } from \"../errors/index.js\";\nimport { Resolver } from \"../dwtoml/index.js\";\n\nimport type { Api } from \"./api.js\";\nimport { httpClient } from \"../http-client/index.js\";\nimport { validateDomain } from \"./utils.js\";\n\n/**\n * The maximum size of response from a federation server\n * @defaultValue 102400\n */\nexport const FEDERATION_RESPONSE_MAX_SIZE: number = 100 * 1024;\n\n/**\n * Federation.Server handles a network connection to a\n * [federation server](https://docs.digitalworld.global/docs/learn/encyclopedia/federation)\n * instance and exposes an interface for requests to that instance.\n *\n * @param serverURL - The federation server URL (ex. `https://acme.com/federation`).\n * @param domain - Domain this server represents\n * @param opts - (optional) Options object\n * @returns  */\nexport class FederationServer {\n  /**\n   * The federation server URL (ex. `https://acme.com/federation`).\n   */\n  private readonly serverURL: URL; // TODO: public or private? readonly?\n\n  /**\n   * Domain this server represents.\n   */\n  private readonly domain: string; // TODO: public or private? readonly?\n\n  /**\n   * Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.\n   */\n  private readonly timeout: number; // TODO: public or private? readonly?\n\n  /**\n   * A helper method for handling user inputs that contain `destination` value.\n   * It accepts two types of values:\n   *\n   * * For Digital World address (ex. `bob*digitalworld.global`) it splits Digital World address and then tries to find information about\n   * federation server in `dw.toml` file for a given domain. It returns a `Promise` which resolves if federation\n   * server exists and user has been found and rejects in all other cases.\n   * * For Account ID (ex. `GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS`) it returns a `Promise` which\n   * resolves if Account ID is valid and rejects in all other cases. Please note that this method does not check\n   * if the account actually exists in a ledger.\n   *\n   * @example\n   * ```ts\n   * DigitalWorldSdk.FederationServer.resolve('bob*digitalworld.global')\n   *  .then(federationRecord => {\n   *    // {\n   *    //   account_id: 'GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS',\n   *    //   memo_type: 'id',\n   *    //   memo: 100\n   *    // }\n   *  });\n   * ```\n   *\n   * @see <a href=\"https://docs.digitalworld.global/docs/learn/encyclopedia/federation\" target=\"_blank\">Federation doc</a>\n   * @see <a href=\"https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info\" target=\"_blank\">dw.toml doc</a>\n   * @param value - Digital World Address (ex. `bob*digitalworld.global`)\n   * @param opts - (optional) Options object\n   * @returns A promise that resolves to the federation record\n   * @throws Will throw an error if the provided account ID is not a valid Ed25519 public key.\n   */\n  public static async resolve(\n    value: string,\n    opts: Api.Options = {},\n  ): Promise<Api.Record> {\n    // Check if `value` is in account ID format\n    if (value.indexOf(\"*\") < 0) {\n      if (!StrKey.isValidEd25519PublicKey(value)) {\n        return Promise.reject(new Error(\"Invalid Account ID\"));\n      }\n      return Promise.resolve({ account_id: value });\n    }\n\n    const addressParts = value.split(\"*\");\n    const [, domain] = addressParts;\n\n    if (addressParts.length !== 2 || !domain) {\n      return Promise.reject(new Error(\"Invalid Digital World address\"));\n    }\n\n    const federationServer = await FederationServer.createForDomain(\n      domain,\n      opts,\n    );\n    return federationServer.resolveAddress(value);\n  }\n\n  /**\n   * Creates a `FederationServer` instance based on information from\n   * [dw.toml](https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info)\n   * file for a given domain.\n   *\n   * If `dw.toml` file does not exist for a given domain or it does not\n   * contain information about a federation server Promise will reject.\n   *\n   * @example\n   * ```ts\n   * DigitalWorldSdk.FederationServer.createForDomain('acme.com')\n   *   .then(federationServer => {\n   *     // federationServer.resolveAddress('bob').then(...)\n   *   })\n   *   .catch(error => {\n   *     // dw.toml does not exist or it does not contain information about federation server.\n   *   });\n   * ```\n   *\n   * @see <a href=\"https://docs.digitalworld.global/docs/issuing-assets/publishing-asset-info\" target=\"_blank\">dw.toml doc</a>\n   * @param domain - Domain to get federation server for\n   * @param opts - (optional) Options object\n   * @returns A promise that resolves to the federation record\n   * @throws Will throw an error if the domain's dw.toml file does not contain a federation server field.\n   */\n  public static async createForDomain(\n    domain: string,\n    opts: Api.Options = {},\n  ): Promise<FederationServer> {\n    validateDomain(domain);\n    const tomlObject = await Resolver.resolve(domain, opts);\n    if (!tomlObject.FEDERATION_SERVER) {\n      return Promise.reject(\n        new Error(\"dw.toml does not contain FEDERATION_SERVER field\"),\n      );\n    }\n    return new FederationServer(tomlObject.FEDERATION_SERVER, domain, opts);\n  }\n\n  public constructor(\n    serverURL: string,\n    domain: string,\n    opts: Api.Options = {},\n  ) {\n    this.serverURL = new URL(serverURL);\n    this.domain = domain;\n    validateDomain(domain);\n\n    const allowHttp =\n      typeof opts.allowHttp === \"undefined\"\n        ? Config.isAllowHttp()\n        : opts.allowHttp;\n\n    this.timeout =\n      typeof opts.timeout === \"undefined\" ? Config.getTimeout() : opts.timeout;\n\n    if (this.serverURL.protocol !== \"https:\" && !allowHttp) {\n      throw new Error(\"Cannot connect to insecure federation server\");\n    }\n  }\n\n  /**\n   * Get the federation record if the user was found for a given Digital World address\n   * @see <a href=\"https://docs.digitalworld.global/docs/encyclopedia/federation\" target=\"_blank\">Federation doc</a>\n   * @param address - Digital World address (ex. `bob*digitalworld.global`). If `FederationServer` was instantiated with `domain` param only username (ex. `bob`) can be passed.\n   * @returns A promise that resolves to the federation record\n   * @throws Will throw an error if the federated address does not contain a domain, or if the server object was not instantiated with a `domain` parameter\n   */\n  public async resolveAddress(address: string): Promise<Api.Record> {\n    let stellarAddress = address;\n    if (address.indexOf(\"*\") < 0) {\n      if (!this.domain) {\n        return Promise.reject(\n          new Error(\n            \"Unknown domain. Make sure `address` contains a domain (ex. `bob*digitalworld.global`) or pass `domain` parameter when instantiating the server object.\",\n          ),\n        );\n      }\n      stellarAddress = `${address}*${this.domain}`;\n    }\n    const url = new URL(this.serverURL);\n    url.search = \"\";\n    url.searchParams.set(\"type\", \"name\");\n    url.searchParams.set(\"q\", stellarAddress);\n    return this._sendRequest(url);\n  }\n\n  /**\n   * Given an account ID, get their federation record if the user was found\n   * @see <a href=\"https://docs.digitalworld.global/docs/encyclopedia/federation\" target=\"_blank\">Federation doc</a>\n   * @param accountId - Account ID (ex. `GBYNR2QJXLBCBTRN44MRORCMI4YO7FZPFBCNOKTOBCAAFC7KC3LNPRYS`)\n   * @returns A promise that resolves to the federation record\n   * @throws Will throw an error if the federation server returns an invalid memo value.\n   * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.\n   * @throws Will throw an error if the server query fails with an improper response.\n   */\n  public async resolveAccountId(accountId: string): Promise<Api.Record> {\n    const url = new URL(this.serverURL);\n    url.search = \"\";\n    url.searchParams.set(\"type\", \"id\");\n    url.searchParams.set(\"q\", accountId);\n    return this._sendRequest(url);\n  }\n\n  /**\n   * Given a transactionId, get the federation record if the sender of the transaction was found\n   * @see <a href=\"https://docs.digitalworld.global/docs/glossary/federation/\" target=\"_blank\">Federation doc</a>\n   * @param transactionId - Transaction ID (ex. `3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889`)\n   * @returns A promise that resolves to the federation record\n   * @throws Will throw an error if the federation server returns an invalid memo value.\n   * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.\n   * @throws Will throw an error if the server query fails with an improper response.\n   */\n  public async resolveTransactionId(\n    transactionId: string,\n  ): Promise<Api.Record> {\n    const url = new URL(this.serverURL);\n    url.search = \"\";\n    url.searchParams.set(\"type\", \"txid\");\n    url.searchParams.set(\"q\", transactionId);\n    return this._sendRequest(url);\n  }\n\n  private async _sendRequest(url: URL) {\n    const timeout = this.timeout;\n\n    return httpClient\n      .get(url.toString(), {\n        maxContentLength: FEDERATION_RESPONSE_MAX_SIZE,\n        timeout,\n      })\n      .then((response) => {\n        if (\n          typeof response.data.memo !== \"undefined\" &&\n          typeof response.data.memo !== \"string\"\n        ) {\n          throw new Error(\"memo value should be of type string\");\n        }\n        return response.data;\n      })\n      .catch((response) => {\n        if (response instanceof Error) {\n          if (response.message.match(/^maxContentLength size/)) {\n            throw new Error(\n              `federation response exceeds allowed size of ${FEDERATION_RESPONSE_MAX_SIZE}`,\n            );\n          } else {\n            return Promise.reject(response);\n          }\n        } else {\n          return Promise.reject(\n            new BadResponseError(\n              `Server query failed. Server responded: ${response.status} ${response.statusText}`,\n              response.data,\n            ),\n          );\n        }\n      });\n  }\n}\n"],"names":["httpClient"],"mappings":"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"}

package/lib/esm/federation/utils.d.ts

@@ -0,0 +1 @@
+export declare function validateDomain(domain: string): void;

package/lib/esm/federation/utils.js

@@ -0,0 +1,12 @@
+function validateDomain(domain) {
+  if (!/^(?:[A-Za-z](?:[A-Za-z0-9-]*[A-Za-z0-9])?\.)*[A-Za-z](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?::\d+)?$/.test(
+    domain
+  )) {
+    throw new Error(
+      "The provided domain is invalid. Ensure that the domain adheres to RFC 1035"
+    );
+  }
+}
+
+export { validateDomain };
+//# sourceMappingURL=utils.js.map

package/lib/esm/federation/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/federation/utils.ts"],"sourcesContent":["export function validateDomain(domain: string): void {\n  // Validate domain per RFC 1035 with an optional port (as required by SEP-0002): each dot-separated\n  // label must start with a letter, end with a letter or digit, and contain only\n  // letters, digits, or hyphens.\n  if (\n    !/^(?:[A-Za-z](?:[A-Za-z0-9-]*[A-Za-z0-9])?\\.)*[A-Za-z](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?::\\d+)?$/.test(\n      domain,\n    )\n  ) {\n    throw new Error(\n      \"The provided domain is invalid. Ensure that the domain adheres to RFC 1035\",\n    );\n  }\n}\n"],"names":[],"mappings":"AAAO,SAAS,eAAe,MAAA,EAAsB;AAInD,EAAA,IACE,CAAC,8FAAA,CAA+F,IAAA;AAAA,IAC9F;AAAA,GACF,EACA;AACA,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACF;;;;"}

package/lib/esm/gateway/account_call_builder.d.ts

@@ -0,0 +1,54 @@
+import { Asset } from "../base/index.js";
+import { CallBuilder } from "./call_builder.js";
+import { ServerApi } from "./server_api.js";
+import type { HttpClient } from "../http-client/index.js";
+/**
+ * Creates a new {@link AccountCallBuilder} pointed to server defined by `serverUrl`.
+ *
+ * Do not create this object directly, use {@link Gateway.Server.accounts}.
+ *
+ * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | All Accounts}
+ *
+ * @param serverUrl - Gateway server URL.
+ */
+export declare class AccountCallBuilder extends CallBuilder<ServerApi.CollectionPage<ServerApi.AccountRecord>> {
+    constructor(serverUrl: URL, httpClient: HttpClient);
+    /**
+     * Returns information and links relating to a single account.
+     * The balances section in the returned JSON will also list all the trust lines this account has set up.
+     *
+     * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/retrieve-an-account | Account Details}
+     * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+     * @returns a new CallBuilder instance for the /accounts/:id endpoint
+     */
+    accountId(id: string): CallBuilder<ServerApi.AccountRecord>;
+    /**
+     * This endpoint filters accounts by signer account.
+     * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+     * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+     * @returns current AccountCallBuilder instance
+     */
+    forSigner(id: string): this;
+    /**
+     * This endpoint filters all accounts who are trustees to an asset.
+     * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+     * @see Asset
+     * @param asset - For example: `new Asset('USD','GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD')`
+     * @returns current AccountCallBuilder instance
+     */
+    forAsset(asset: Asset): this;
+    /**
+     * This endpoint filters accounts where the given account is sponsoring the account or any of its sub-entries..
+     * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+     * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+     * @returns current AccountCallBuilder instance
+     */
+    sponsor(id: string): this;
+    /**
+     * This endpoint filters accounts holding a trustline to the given liquidity pool.
+     *
+     * @param id - The ID of the liquidity pool. For example: `dd7b1ab831c273310ddbec6f97870aa83c2fbd78ce22aded37ecbf4f3380fac7`.
+     * @returns current AccountCallBuilder instance
+     */
+    forLiquidityPool(id: string): this;
+}

package/lib/esm/gateway/account_call_builder.js

@@ -0,0 +1,68 @@
+import { CallBuilder } from './call_builder.js';
+
+class AccountCallBuilder extends CallBuilder {
+  constructor(serverUrl, httpClient) {
+    super(serverUrl, httpClient);
+    this.setPath("accounts");
+  }
+  /**
+   * Returns information and links relating to a single account.
+   * The balances section in the returned JSON will also list all the trust lines this account has set up.
+   *
+   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/retrieve-an-account | Account Details}
+   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+   * @returns a new CallBuilder instance for the /accounts/:id endpoint
+   */
+  accountId(id) {
+    const builder = new CallBuilder(
+      new URL(this.url),
+      this.httpClient
+    );
+    builder.filter.push([id]);
+    return builder;
+  }
+  /**
+   * This endpoint filters accounts by signer account.
+   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+   * @returns current AccountCallBuilder instance
+   */
+  forSigner(id) {
+    this.url.searchParams.set("signer", id);
+    return this;
+  }
+  /**
+   * This endpoint filters all accounts who are trustees to an asset.
+   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+   * @see Asset
+   * @param asset - For example: `new Asset('USD','GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD')`
+   * @returns current AccountCallBuilder instance
+   */
+  forAsset(asset) {
+    this.url.searchParams.set("asset", `${asset}`);
+    return this;
+  }
+  /**
+   * This endpoint filters accounts where the given account is sponsoring the account or any of its sub-entries..
+   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}
+   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+   * @returns current AccountCallBuilder instance
+   */
+  sponsor(id) {
+    this.url.searchParams.set("sponsor", id);
+    return this;
+  }
+  /**
+   * This endpoint filters accounts holding a trustline to the given liquidity pool.
+   *
+   * @param id - The ID of the liquidity pool. For example: `dd7b1ab831c273310ddbec6f97870aa83c2fbd78ce22aded37ecbf4f3380fac7`.
+   * @returns current AccountCallBuilder instance
+   */
+  forLiquidityPool(id) {
+    this.url.searchParams.set("liquidity_pool", id);
+    return this;
+  }
+}
+
+export { AccountCallBuilder };
+//# sourceMappingURL=account_call_builder.js.map

package/lib/esm/gateway/account_call_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account_call_builder.js","sources":["../../../src/gateway/account_call_builder.ts"],"sourcesContent":["import { Asset } from \"../base/index.js\";\nimport { CallBuilder } from \"./call_builder.js\";\nimport { ServerApi } from \"./server_api.js\";\nimport type { HttpClient } from \"../http-client/index.js\";\n/**\n * Creates a new {@link AccountCallBuilder} pointed to server defined by `serverUrl`.\n *\n * Do not create this object directly, use {@link Gateway.Server.accounts}.\n *\n * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | All Accounts}\n *\n * @param serverUrl - Gateway server URL.\n */\nexport class AccountCallBuilder extends CallBuilder<\n  ServerApi.CollectionPage<ServerApi.AccountRecord>\n> {\n  constructor(serverUrl: URL, httpClient: HttpClient) {\n    super(serverUrl, httpClient);\n    this.setPath(\"accounts\");\n  }\n\n  /**\n   * Returns information and links relating to a single account.\n   * The balances section in the returned JSON will also list all the trust lines this account has set up.\n   *\n   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/retrieve-an-account | Account Details}\n   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`\n   * @returns a new CallBuilder instance for the /accounts/:id endpoint\n   */\n  public accountId(id: string): CallBuilder<ServerApi.AccountRecord> {\n    const builder = new CallBuilder<ServerApi.AccountRecord>(\n      new URL(this.url),\n      this.httpClient,\n    );\n    builder.filter.push([id]);\n    return builder;\n  }\n\n  /**\n   * This endpoint filters accounts by signer account.\n   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}\n   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`\n   * @returns current AccountCallBuilder instance\n   */\n  public forSigner(id: string): this {\n    this.url.searchParams.set(\"signer\", id);\n    return this;\n  }\n\n  /**\n   * This endpoint filters all accounts who are trustees to an asset.\n   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}\n   * @see Asset\n   * @param asset - For example: `new Asset('USD','GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD')`\n   * @returns current AccountCallBuilder instance\n   */\n  public forAsset(asset: Asset): this {\n    this.url.searchParams.set(\"asset\", `${asset}`);\n    return this;\n  }\n\n  /**\n   * This endpoint filters accounts where the given account is sponsoring the account or any of its sub-entries..\n   * @see {@link https://docs.digitalworld.global/docs/data/horizon/api-reference/resources/list-all-accounts | Accounts}\n   * @param id - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`\n   * @returns current AccountCallBuilder instance\n   */\n  public sponsor(id: string): this {\n    this.url.searchParams.set(\"sponsor\", id);\n    return this;\n  }\n\n  /**\n   * This endpoint filters accounts holding a trustline to the given liquidity pool.\n   *\n   * @param id - The ID of the liquidity pool. For example: `dd7b1ab831c273310ddbec6f97870aa83c2fbd78ce22aded37ecbf4f3380fac7`.\n   * @returns current AccountCallBuilder instance\n   */\n  public forLiquidityPool(id: string): this {\n    this.url.searchParams.set(\"liquidity_pool\", id);\n    return this;\n  }\n}\n"],"names":[],"mappings":";;AAaO,MAAM,2BAA2B,WAAA,CAEtC;AAAA,EACA,WAAA,CAAY,WAAgB,UAAA,EAAwB;AAClD,IAAA,KAAA,CAAM,WAAW,UAAU,CAAA;AAC3B,IAAA,IAAA,CAAK,QAAQ,UAAU,CAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,UAAU,EAAA,EAAkD;AACjE,IAAA,MAAM,UAAU,IAAI,WAAA;AAAA,MAClB,IAAI,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA;AAAA,MAChB,IAAA,CAAK;AAAA,KACP;AACA,IAAA,OAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,CAAC,EAAE,CAAC,CAAA;AACxB,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,UAAU,EAAA,EAAkB;AACjC,IAAA,IAAA,CAAK,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,EAAE,CAAA;AACtC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,SAAS,KAAA,EAAoB;AAClC,IAAA,IAAA,CAAK,IAAI,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,CAAA,EAAG,KAAK,CAAA,CAAE,CAAA;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,QAAQ,EAAA,EAAkB;AAC/B,IAAA,IAAA,CAAK,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,EAAE,CAAA;AACvC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,iBAAiB,EAAA,EAAkB;AACxC,IAAA,IAAA,CAAK,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,gBAAA,EAAkB,EAAE,CAAA;AAC9C,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;;"}

package/lib/esm/gateway/account_response.d.ts

@@ -0,0 +1,62 @@
+import type { TransactionSource } from "../base/index.js";
+import { GatewayApi } from "./gateway_api.js";
+import { ServerApi } from "./server_api.js";
+/**
+ * Do not create this object directly, use {@link Gateway.Server.loadAccount | Gateway.Server#loadAccount}.
+ *
+ * Returns information and links relating to a single account.
+ * The balances section in the returned JSON will also list all the trust lines this account has set up.
+ * It also contains {@link BaseAccount} object and exposes it's methods so can be used in {@link TransactionBuilder}.
+ *
+ * @see {@link https://docs.digitalworld.global/docs/data/gateway/api-reference/resources/accounts/object | Account Details}
+ * @param response - Response from gateway account endpoint.
+ * @returns AccountResponse instance
+ */
+export declare class AccountResponse implements TransactionSource {
+    readonly id: string;
+    readonly paging_token: string;
+    readonly account_id: string;
+    sequence: string;
+    readonly sequence_ledger?: number;
+    readonly sequence_time?: string;
+    readonly subentry_count: number;
+    readonly home_domain?: string;
+    readonly inflation_destination?: string;
+    readonly last_modified_ledger: number;
+    readonly last_modified_time: string;
+    readonly thresholds: GatewayApi.AccountThresholds;
+    readonly flags: GatewayApi.Flags;
+    readonly balances: GatewayApi.BalanceLine[];
+    readonly signers: ServerApi.AccountRecordSigners[];
+    readonly num_sponsoring: number;
+    readonly num_sponsored: number;
+    readonly sponsor?: string;
+    readonly data: (options: {
+        value: string;
+    }) => Promise<{
+        value: string;
+    }>;
+    readonly data_attr: Record<string, string>;
+    readonly effects: ServerApi.CallCollectionFunction<ServerApi.EffectRecord>;
+    readonly offers: ServerApi.CallCollectionFunction<ServerApi.OfferRecord>;
+    readonly operations: ServerApi.CallCollectionFunction<ServerApi.OperationRecord>;
+    readonly payments: ServerApi.CallCollectionFunction<ServerApi.PaymentOperationRecord>;
+    readonly trades: ServerApi.CallCollectionFunction<ServerApi.TradeRecord>;
+    readonly transactions: ServerApi.CallCollectionFunction<ServerApi.TransactionRecord>;
+    private readonly _baseAccount;
+    constructor(response: ServerApi.AccountRecord);
+    /**
+     * Get Digital World account public key ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`
+     * @returns accountId
+     */
+    accountId(): string;
+    /**
+     * Get the current sequence number
+     * @returns sequenceNumber
+     */
+    sequenceNumber(): string;
+    /**
+     * Increments sequence number in this object by one.
+     * @returns    */
+    incrementSequenceNumber(): void;
+}