@digitalworld/digital-world-sdk 16.0.0

package/lib/esm/base/memo.d.ts

@@ -0,0 +1,112 @@
+import xdr from "./xdr.js";
+/**
+ * Type of {@link Memo}.
+ */
+export declare const MemoNone = "none";
+/**
+ * Type of {@link Memo}.
+ */
+export declare const MemoID = "id";
+/**
+ * Type of {@link Memo}.
+ */
+export declare const MemoText = "text";
+/**
+ * Type of {@link Memo}.
+ */
+export declare const MemoHash = "hash";
+/**
+ * Type of {@link Memo}.
+ */
+export declare const MemoReturn = "return";
+export type MemoTypeNone = typeof MemoNone;
+export type MemoTypeID = typeof MemoID;
+export type MemoTypeText = typeof MemoText;
+export type MemoTypeHash = typeof MemoHash;
+export type MemoTypeReturn = typeof MemoReturn;
+export declare namespace MemoType {
+    type None = MemoTypeNone;
+    type ID = MemoTypeID;
+    type Text = MemoTypeText;
+    type Hash = MemoTypeHash;
+    type Return = MemoTypeReturn;
+}
+export type MemoType = MemoTypeHash | MemoTypeID | MemoTypeNone | MemoTypeReturn | MemoTypeText;
+export type MemoValue = Buffer | string | null;
+type MemoValueMap = {
+    [MemoNone]: null;
+    [MemoID]: string;
+    [MemoText]: Buffer | string;
+    [MemoHash]: Buffer;
+    [MemoReturn]: Buffer;
+};
+type MemoTypeToValue<T extends MemoType> = MemoValueMap[T];
+/**
+ * `Memo` represents memos attached to transactions.
+ *
+ * @see [Transactions concept](https://docs.digitalworld.global/docs/glossary/transactions/)
+ */
+export declare class Memo<T extends MemoType = MemoType> {
+    private _type;
+    private _value;
+    constructor(type: MemoType.None, value?: null);
+    constructor(type: MemoType.Hash | MemoType.Return, value: Buffer);
+    constructor(type: MemoType.Hash | MemoType.ID | MemoType.Return | MemoType.Text, value: string);
+    constructor(type: T, value: MemoValue);
+    /**
+     * Contains memo type: `MemoNone`, `MemoID`, `MemoText`, `MemoHash` or `MemoReturn`
+     */
+    get type(): T;
+    set type(_type: T);
+    /**
+     * Contains memo value:
+     * * `null` for `MemoNone`,
+     * * `string` for `MemoID`,
+     * * `Buffer` for `MemoText` after decoding using `fromXDRObject`, original value otherwise,
+     * * `Buffer` for `MemoHash`, `MemoReturn`.
+     */
+    get value(): MemoTypeToValue<T>;
+    set value(_value: MemoTypeToValue<T>);
+    private static _validateIdValue;
+    private static _validateTextValue;
+    private static _validateHashValue;
+    /**
+     * Returns an empty memo (`MemoNone`).
+     */
+    static none(): Memo<MemoTypeNone>;
+    /**
+     * Creates and returns a `MemoText` memo.
+     *
+     * @param text - memo text
+     */
+    static text(text: string): Memo<MemoTypeText>;
+    /**
+     * Creates and returns a `MemoID` memo.
+     *
+     * @param id - 64-bit number represented as a string
+     */
+    static id(id: string): Memo<MemoTypeID>;
+    /**
+     * Creates and returns a `MemoHash` memo.
+     *
+     * @param hash - 32 byte hash or hex encoded string
+     */
+    static hash(hash: Buffer | string): Memo<MemoTypeHash>;
+    /**
+     * Creates and returns a `MemoReturn` memo.
+     *
+     * @param hash - 32 byte hash or hex encoded string
+     */
+    static return(hash: Buffer | string): Memo<MemoTypeReturn>;
+    /**
+     * Returns XDR memo object.
+     */
+    toXDRObject(): xdr.Memo;
+    /**
+     * Returns {@link Memo} from XDR memo object.
+     *
+     * @param object - XDR memo object
+     */
+    static fromXDRObject(object: xdr.Memo): Memo;
+}
+export {};

package/lib/esm/base/memo.js

@@ -0,0 +1,230 @@
+import { Buffer } from 'buffer';
+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 { UnsignedHyper } from '../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 BigNumber from './util/bignumber.js';
+import types from './generated/curr_generated.js';
+
+const MemoNone = "none";
+const MemoID = "id";
+const MemoText = "text";
+const MemoHash = "hash";
+const MemoReturn = "return";
+class Memo {
+  _type;
+  _value;
+  /**
+   * @param type - `MemoNone`, `MemoID`, `MemoText`, `MemoHash` or `MemoReturn`
+   * @param value - `string` for `MemoID`, `MemoText`, buffer or hex string for `MemoHash` or `MemoReturn`
+   */
+  constructor(type, value = null) {
+    this._type = type;
+    this._value = value;
+    switch (this._type) {
+      case MemoNone:
+        break;
+      case MemoID:
+        Memo._validateIdValue(value);
+        break;
+      case MemoText:
+        Memo._validateTextValue(value);
+        break;
+      case MemoHash:
+      case MemoReturn:
+        Memo._validateHashValue(value);
+        if (typeof value === "string") {
+          this._value = Buffer.from(value, "hex");
+        }
+        break;
+      default:
+        throw new Error("Invalid memo type");
+    }
+  }
+  /**
+   * Contains memo type: `MemoNone`, `MemoID`, `MemoText`, `MemoHash` or `MemoReturn`
+   */
+  get type() {
+    return this._type;
+  }
+  set type(_type) {
+    throw new Error("Memo is immutable");
+  }
+  /**
+   * Contains memo value:
+   * * `null` for `MemoNone`,
+   * * `string` for `MemoID`,
+   * * `Buffer` for `MemoText` after decoding using `fromXDRObject`, original value otherwise,
+   * * `Buffer` for `MemoHash`, `MemoReturn`.
+   */
+  get value() {
+    switch (this._type) {
+      case MemoNone:
+        return null;
+      case MemoID:
+      case MemoText:
+        return this._value;
+      case MemoHash:
+      case MemoReturn:
+        return Buffer.from(this._value);
+      default:
+        throw new Error("Invalid memo type");
+    }
+  }
+  set value(_value) {
+    throw new Error("Memo is immutable");
+  }
+  static _validateIdValue(value) {
+    const error = new Error(`Expects a uint64 as a string. Got ${value}`);
+    if (typeof value !== "string") {
+      throw error;
+    }
+    if (!/^[0-9]+$/.test(value)) {
+      throw error;
+    }
+    let number;
+    try {
+      number = new BigNumber(value);
+    } catch {
+      throw error;
+    }
+    if (!number.isFinite()) {
+      throw error;
+    }
+    if (number.isNaN()) {
+      throw error;
+    }
+    if (number.isNegative()) {
+      throw error;
+    }
+    if (!number.isInteger()) {
+      throw error;
+    }
+    if (number.isGreaterThan("18446744073709551615")) {
+      throw error;
+    }
+  }
+  static _validateTextValue(value) {
+    if (typeof value === "string") {
+      if (Buffer.byteLength(value, "utf8") > 28) {
+        throw new Error("Expects string, array or buffer, max 28 bytes");
+      }
+    } else if (Buffer.isBuffer(value)) {
+      if (value.length > 28) {
+        throw new Error("Expects string, array or buffer, max 28 bytes");
+      }
+    } else {
+      if (!types.Memo.armTypeForArm("text").isValid(value)) {
+        throw new Error("Expects string, array or buffer, max 28 bytes");
+      }
+    }
+  }
+  static _validateHashValue(value) {
+    const error = new Error(
+      `Expects a 32 byte hash value or hex encoded string. Got ${String(value)}`
+    );
+    if (value === null || typeof value === "undefined") {
+      throw error;
+    }
+    let valueBuffer;
+    if (typeof value === "string") {
+      if (!/^[0-9A-Fa-f]{64}$/g.test(value)) {
+        throw error;
+      }
+      valueBuffer = Buffer.from(value, "hex");
+    } else if (Buffer.isBuffer(value)) {
+      valueBuffer = Buffer.from(value);
+    } else {
+      throw error;
+    }
+    if (!valueBuffer.length || valueBuffer.length !== 32) {
+      throw error;
+    }
+  }
+  /**
+   * Returns an empty memo (`MemoNone`).
+   */
+  static none() {
+    return new Memo(MemoNone);
+  }
+  /**
+   * Creates and returns a `MemoText` memo.
+   *
+   * @param text - memo text
+   */
+  static text(text) {
+    return new Memo(MemoText, text);
+  }
+  /**
+   * Creates and returns a `MemoID` memo.
+   *
+   * @param id - 64-bit number represented as a string
+   */
+  static id(id) {
+    return new Memo(MemoID, id);
+  }
+  /**
+   * Creates and returns a `MemoHash` memo.
+   *
+   * @param hash - 32 byte hash or hex encoded string
+   */
+  static hash(hash) {
+    return new Memo(MemoHash, hash);
+  }
+  /**
+   * Creates and returns a `MemoReturn` memo.
+   *
+   * @param hash - 32 byte hash or hex encoded string
+   */
+  static return(hash) {
+    return new Memo(MemoReturn, hash);
+  }
+  /**
+   * Returns XDR memo object.
+   */
+  toXDRObject() {
+    switch (this._type) {
+      case MemoNone:
+        return types.Memo.memoNone();
+      case MemoID:
+        return types.Memo.memoId(
+          types.Uint64.fromString(
+            UnsignedHyper.fromString(this._value).toString()
+          )
+        );
+      case MemoText:
+        return types.Memo.memoText(this._value);
+      case MemoHash:
+        return types.Memo.memoHash(this._value);
+      case MemoReturn:
+        return types.Memo.memoReturn(this._value);
+      default:
+        throw new Error("Invalid memo type");
+    }
+  }
+  /**
+   * Returns {@link Memo} from XDR memo object.
+   *
+   * @param object - XDR memo object
+   */
+  static fromXDRObject(object) {
+    switch (object.switch()) {
+      case types.MemoType.memoId():
+        return Memo.id(object.id().toString());
+      case types.MemoType.memoText():
+        return Memo.text(object.value());
+      case types.MemoType.memoHash():
+        return Memo.hash(object.hash());
+      case types.MemoType.memoReturn():
+        return Memo.return(object.retHash());
+    }
+    if (typeof object.value() === "undefined") {
+      return Memo.none();
+    }
+    throw new Error("Unknown type");
+  }
+}
+
+export { Memo, MemoHash, MemoID, MemoNone, MemoReturn, MemoText };
+//# sourceMappingURL=memo.js.map

package/lib/esm/base/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sources":["../../../src/base/memo.ts"],"sourcesContent":["import { UnsignedHyper } from \"@stellar/js-xdr\";\nimport CustomBigNumber from \"./util/bignumber.js\";\nimport type { BigNumber } from \"./util/bignumber.js\";\nimport xdr from \"./xdr.js\";\n\n/**\n * Type of {@link Memo}.\n */\nexport const MemoNone = \"none\";\n/**\n * Type of {@link Memo}.\n */\nexport const MemoID = \"id\";\n/**\n * Type of {@link Memo}.\n */\nexport const MemoText = \"text\";\n/**\n * Type of {@link Memo}.\n */\nexport const MemoHash = \"hash\";\n/**\n * Type of {@link Memo}.\n */\nexport const MemoReturn = \"return\";\n\nexport type MemoTypeNone = typeof MemoNone;\nexport type MemoTypeID = typeof MemoID;\nexport type MemoTypeText = typeof MemoText;\nexport type MemoTypeHash = typeof MemoHash;\nexport type MemoTypeReturn = typeof MemoReturn;\n\nexport namespace MemoType {\n  export type None = MemoTypeNone;\n  export type ID = MemoTypeID;\n  export type Text = MemoTypeText;\n  export type Hash = MemoTypeHash;\n  export type Return = MemoTypeReturn;\n}\nexport type MemoType =\n  | MemoTypeHash\n  | MemoTypeID\n  | MemoTypeNone\n  | MemoTypeReturn\n  | MemoTypeText;\n\nexport type MemoValue = Buffer | string | null;\n\ntype MemoValueMap = {\n  [MemoNone]: null;\n  [MemoID]: string;\n  [MemoText]: Buffer | string;\n  [MemoHash]: Buffer;\n  [MemoReturn]: Buffer;\n};\n\ntype MemoTypeToValue<T extends MemoType> = MemoValueMap[T];\n/**\n * `Memo` represents memos attached to transactions.\n *\n * @see [Transactions concept](https://docs.digitalworld.global/docs/glossary/transactions/)\n */\nexport class Memo<T extends MemoType = MemoType> {\n  private _type: T;\n  private _value: MemoValue;\n\n  constructor(type: MemoType.None, value?: null);\n  constructor(type: MemoType.Hash | MemoType.Return, value: Buffer);\n  constructor(\n    type: MemoType.Hash | MemoType.ID | MemoType.Return | MemoType.Text,\n    value: string,\n  );\n  constructor(type: T, value: MemoValue);\n  /**\n   * @param type - `MemoNone`, `MemoID`, `MemoText`, `MemoHash` or `MemoReturn`\n   * @param value - `string` for `MemoID`, `MemoText`, buffer or hex string for `MemoHash` or `MemoReturn`\n   */\n  constructor(type: T, value: MemoValue = null) {\n    this._type = type;\n    this._value = value;\n\n    switch (this._type) {\n      case MemoNone:\n        break;\n      case MemoID:\n        Memo._validateIdValue(value as string);\n        break;\n      case MemoText:\n        Memo._validateTextValue(value);\n        break;\n      case MemoHash:\n      case MemoReturn:\n        Memo._validateHashValue(value);\n        // We want MemoHash and MemoReturn to have Buffer as a value\n        if (typeof value === \"string\") {\n          this._value = Buffer.from(value, \"hex\");\n        }\n        break;\n      default:\n        throw new Error(\"Invalid memo type\");\n    }\n  }\n\n  /**\n   * Contains memo type: `MemoNone`, `MemoID`, `MemoText`, `MemoHash` or `MemoReturn`\n   */\n  get type(): T {\n    return this._type;\n  }\n\n  set type(_type: T) {\n    throw new Error(\"Memo is immutable\");\n  }\n\n  /**\n   * Contains memo value:\n   * * `null` for `MemoNone`,\n   * * `string` for `MemoID`,\n   * * `Buffer` for `MemoText` after decoding using `fromXDRObject`, original value otherwise,\n   * * `Buffer` for `MemoHash`, `MemoReturn`.\n   */\n  get value(): MemoTypeToValue<T> {\n    switch (this._type) {\n      case MemoNone:\n        return null as MemoTypeToValue<T>;\n      case MemoID:\n      case MemoText:\n        return this._value as MemoTypeToValue<T>;\n      case MemoHash:\n      case MemoReturn:\n        return Buffer.from(this._value as Buffer) as MemoTypeToValue<T>;\n      default:\n        throw new Error(\"Invalid memo type\");\n    }\n  }\n\n  set value(_value: MemoTypeToValue<T>) {\n    throw new Error(\"Memo is immutable\");\n  }\n\n  private static _validateIdValue(value: string): void {\n    const error = new Error(`Expects a uint64 as a string. Got ${value}`);\n\n    if (typeof value !== \"string\") {\n      throw error;\n    }\n\n    // Only plain decimal digit strings are accepted. Scientific notation\n    // (\"1e18\") and trailing-zero decimals (\"1.0\") pass BigNumber validation\n    // but crash in BigInt() during XDR serialization.\n    if (!/^[0-9]+$/.test(value)) {\n      throw error;\n    }\n\n    let number: BigNumber;\n    try {\n      number = new CustomBigNumber(value);\n    } catch {\n      throw error;\n    }\n\n    // Infinity\n    if (!number.isFinite()) {\n      throw error;\n    }\n\n    // NaN\n    if (number.isNaN()) {\n      throw error;\n    }\n\n    // Negative\n    if (number.isNegative()) {\n      throw error;\n    }\n\n    // Decimal\n    if (!number.isInteger()) {\n      throw error;\n    }\n\n    // Exceeds uint64 max (2^64 - 1)\n    if (number.isGreaterThan(\"18446744073709551615\")) {\n      throw error;\n    }\n  }\n\n  private static _validateTextValue(value: MemoValue): void {\n    if (typeof value === \"string\") {\n      if (Buffer.byteLength(value, \"utf8\") > 28) {\n        throw new Error(\"Expects string, array or buffer, max 28 bytes\");\n      }\n    } else if (Buffer.isBuffer(value)) {\n      if (value.length > 28) {\n        throw new Error(\"Expects string, array or buffer, max 28 bytes\");\n      }\n    } else {\n      if (!(xdr.Memo as any).armTypeForArm(\"text\").isValid(value)) {\n        throw new Error(\"Expects string, array or buffer, max 28 bytes\");\n      }\n    }\n  }\n\n  private static _validateHashValue(value: MemoValue): void {\n    const error = new Error(\n      `Expects a 32 byte hash value or hex encoded string. Got ${String(value)}`,\n    );\n\n    if (value === null || typeof value === \"undefined\") {\n      throw error;\n    }\n\n    let valueBuffer: Buffer;\n    if (typeof value === \"string\") {\n      if (!/^[0-9A-Fa-f]{64}$/g.test(value)) {\n        throw error;\n      }\n      valueBuffer = Buffer.from(value, \"hex\");\n    } else if (Buffer.isBuffer(value)) {\n      valueBuffer = Buffer.from(value);\n    } else {\n      throw error;\n    }\n\n    if (!valueBuffer.length || valueBuffer.length !== 32) {\n      throw error;\n    }\n  }\n\n  /**\n   * Returns an empty memo (`MemoNone`).\n   */\n  static none(): Memo<MemoTypeNone> {\n    return new Memo(MemoNone);\n  }\n\n  /**\n   * Creates and returns a `MemoText` memo.\n   *\n   * @param text - memo text\n   */\n  static text(text: string): Memo<MemoTypeText> {\n    return new Memo(MemoText, text);\n  }\n\n  /**\n   * Creates and returns a `MemoID` memo.\n   *\n   * @param id - 64-bit number represented as a string\n   */\n  static id(id: string): Memo<MemoTypeID> {\n    return new Memo(MemoID, id);\n  }\n\n  /**\n   * Creates and returns a `MemoHash` memo.\n   *\n   * @param hash - 32 byte hash or hex encoded string\n   */\n  static hash(hash: Buffer | string): Memo<MemoTypeHash> {\n    return new Memo(MemoHash, hash);\n  }\n\n  /**\n   * Creates and returns a `MemoReturn` memo.\n   *\n   * @param hash - 32 byte hash or hex encoded string\n   */\n  static return(hash: Buffer | string): Memo<MemoTypeReturn> {\n    return new Memo(MemoReturn, hash);\n  }\n\n  /**\n   * Returns XDR memo object.\n   */\n  toXDRObject(): xdr.Memo {\n    switch (this._type) {\n      case MemoNone:\n        return xdr.Memo.memoNone();\n      case MemoID:\n        return xdr.Memo.memoId(\n          xdr.Uint64.fromString(\n            UnsignedHyper.fromString(this._value as string).toString(),\n          ),\n        );\n      case MemoText:\n        return xdr.Memo.memoText(this._value as string);\n      case MemoHash:\n        return xdr.Memo.memoHash(this._value as Buffer);\n      case MemoReturn:\n        return xdr.Memo.memoReturn(this._value as Buffer);\n      default:\n        throw new Error(\"Invalid memo type\");\n    }\n  }\n\n  /**\n   * Returns {@link Memo} from XDR memo object.\n   *\n   * @param object - XDR memo object\n   */\n  static fromXDRObject(object: xdr.Memo): Memo {\n    switch (object.switch()) {\n      case xdr.MemoType.memoId():\n        return Memo.id(object.id().toString());\n      case xdr.MemoType.memoText():\n        return Memo.text(object.value() as string);\n      case xdr.MemoType.memoHash():\n        return Memo.hash(object.hash());\n      case xdr.MemoType.memoReturn():\n        return Memo.return(object.retHash());\n      default:\n        break;\n    }\n\n    if (typeof object.value() === \"undefined\") {\n      return Memo.none();\n    }\n\n    throw new Error(\"Unknown type\");\n  }\n}\n"],"names":["CustomBigNumber","xdr"],"mappings":"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"}

package/lib/esm/base/muxed_account.d.ts

@@ -0,0 +1,94 @@
+import xdr from "./xdr.js";
+import { Account } from "./account.js";
+import type { TransactionSource } from "./transaction_source.js";
+/**
+ * Represents a muxed account for transactions and operations.
+ *
+ * A muxed (or *multiplexed*) account (defined rigorously in
+ * [CAP-27](https://docs.digitalworld.global/protocol/cap-27) and briefly in
+ * [SEP-23](https://docs.digitalworld.global/protocol/sep-23)) is one that resolves a single
+ * Digital World `G...` account to many different underlying IDs.
+ *
+ * For example, you may have a single Digital World address for accounting purposes:
+ *   GA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJVSGZ
+ *
+ * Yet would like to use it for 4 different family members:
+ *   1: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAGZFQ
+ *   2: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAALIWQ
+ *   3: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAPYHQ
+ *   4: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAQLQQ
+ *
+ * This object makes it easy to create muxed accounts from regular accounts,
+ * duplicate them, get/set the underlying IDs, etc. without mucking around with
+ * the raw XDR.
+ *
+ * Because muxed accounts are purely an off-chain convention, they all share the
+ * sequence number tied to their underlying G... account. Thus, this object
+ * *requires* an {@link Account} instance to be passed in, so that muxed
+ * instances of an account can collectively modify the sequence number whenever
+ * a muxed account is used as the source of a {@link Transaction} with {@link
+ * TransactionBuilder}.
+ *
+ * @see https://docs.digitalworld.global/docs/glossary/muxed-accounts/
+ */
+export declare class MuxedAccount implements TransactionSource {
+    private account;
+    private _muxedXdr;
+    private _mAddress;
+    private _id;
+    /**
+     * @param baseAccount - the {@link Account} instance representing the
+     *     underlying G... address
+     * @param id - a stringified uint64 value that represents the ID of the
+     *     muxed account
+     */
+    constructor(baseAccount: Account, id: string);
+    /**
+     * Parses an M-address into a MuxedAccount object.
+     *
+     * @param  mAddress    - an M-address to transform
+     * @param  sequenceNum - the sequence number of the underlying {@link
+     *     Account}, to use for the underlying base account {@link
+     *     MuxedAccount.baseAccount}. If you're using the SDK, you can use
+     *     `server.loadAccount` to fetch this if you don't know it.
+     */
+    static fromAddress(mAddress: string, sequenceNum: string): MuxedAccount;
+    /**
+     * Returns the underlying account object shared among all muxed
+     * accounts with this Digital World address.
+     */
+    baseAccount(): Account;
+    /**
+     * Returns the M-address representing this account's (G-address, ID).
+     */
+    accountId(): string;
+    /**
+     * Returns the uint64 ID of this muxed account as a string.
+     */
+    id(): string;
+    /**
+     * Updates the muxed account's ID, regenerating the M-address accordingly.
+     *
+     * @param id - a stringified uint64 value to set as the new muxed account ID
+     */
+    setId(id: string): MuxedAccount;
+    /**
+     * Returns the stringified sequence number for the underlying account.
+     */
+    sequenceNumber(): string;
+    /**
+     * Increments the underlying account's sequence number by one.
+     */
+    incrementSequenceNumber(): void;
+    /**
+     * Returns the XDR object representing this muxed account's
+     * G-address and uint64 ID.
+     */
+    toXDRObject(): xdr.MuxedAccount;
+    /**
+     * Checks whether two muxed accounts are equal by comparing their M-addresses.
+     *
+     * @param otherMuxedAccount - the MuxedAccount to compare against
+     */
+    equals(otherMuxedAccount: MuxedAccount): boolean;
+}

package/lib/esm/base/muxed_account.js

@@ -0,0 +1,121 @@
+import types from './generated/curr_generated.js';
+import { Account } from './account.js';
+import { StrKey } from './strkey.js';
+import { encodeMuxedAccount, encodeMuxedAccountToAddress, decodeAddressToMuxedAccount, extractBaseAddress } from './util/decode_encode_muxed_account.js';
+
+const MAX_UINT64 = BigInt("18446744073709551615");
+function validateUint64Id(id) {
+  let value;
+  try {
+    value = BigInt(id);
+  } catch {
+    throw new Error(`id is not a valid uint64 string: ${id}`);
+  }
+  if (value < BigInt(0) || value > MAX_UINT64) {
+    throw new Error(
+      `id value out of range for uint64 [0, ${MAX_UINT64}]: ${id}`
+    );
+  }
+}
+class MuxedAccount {
+  account;
+  _muxedXdr;
+  _mAddress;
+  _id;
+  /**
+   * @param baseAccount - the {@link Account} instance representing the
+   *     underlying G... address
+   * @param id - a stringified uint64 value that represents the ID of the
+   *     muxed account
+   */
+  constructor(baseAccount, id) {
+    const accountId = baseAccount.accountId();
+    if (!StrKey.isValidEd25519PublicKey(accountId)) {
+      throw new Error("accountId is invalid");
+    }
+    validateUint64Id(id);
+    this.account = baseAccount;
+    this._muxedXdr = encodeMuxedAccount(accountId, id);
+    this._mAddress = encodeMuxedAccountToAddress(this._muxedXdr);
+    this._id = id;
+  }
+  /**
+   * Parses an M-address into a MuxedAccount object.
+   *
+   * @param  mAddress    - an M-address to transform
+   * @param  sequenceNum - the sequence number of the underlying {@link
+   *     Account}, to use for the underlying base account {@link
+   *     MuxedAccount.baseAccount}. If you're using the SDK, you can use
+   *     `server.loadAccount` to fetch this if you don't know it.
+   */
+  static fromAddress(mAddress, sequenceNum) {
+    const muxedAccount = decodeAddressToMuxedAccount(mAddress);
+    const gAddress = extractBaseAddress(mAddress);
+    const id = muxedAccount.med25519().id().toString();
+    return new MuxedAccount(new Account(gAddress, sequenceNum), id);
+  }
+  /**
+   * Returns the underlying account object shared among all muxed
+   * accounts with this Digital World address.
+   */
+  baseAccount() {
+    return this.account;
+  }
+  /**
+   * Returns the M-address representing this account's (G-address, ID).
+   */
+  accountId() {
+    return this._mAddress;
+  }
+  /**
+   * Returns the uint64 ID of this muxed account as a string.
+   */
+  id() {
+    return this._id;
+  }
+  /**
+   * Updates the muxed account's ID, regenerating the M-address accordingly.
+   *
+   * @param id - a stringified uint64 value to set as the new muxed account ID
+   */
+  setId(id) {
+    if (typeof id !== "string") {
+      throw new Error("id should be a string representing a number (uint64)");
+    }
+    validateUint64Id(id);
+    this._muxedXdr.med25519().id(types.Uint64.fromString(id));
+    this._mAddress = encodeMuxedAccountToAddress(this._muxedXdr);
+    this._id = id;
+    return this;
+  }
+  /**
+   * Returns the stringified sequence number for the underlying account.
+   */
+  sequenceNumber() {
+    return this.account.sequenceNumber();
+  }
+  /**
+   * Increments the underlying account's sequence number by one.
+   */
+  incrementSequenceNumber() {
+    this.account.incrementSequenceNumber();
+  }
+  /**
+   * Returns the XDR object representing this muxed account's
+   * G-address and uint64 ID.
+   */
+  toXDRObject() {
+    return this._muxedXdr;
+  }
+  /**
+   * Checks whether two muxed accounts are equal by comparing their M-addresses.
+   *
+   * @param otherMuxedAccount - the MuxedAccount to compare against
+   */
+  equals(otherMuxedAccount) {
+    return this.accountId() === otherMuxedAccount.accountId();
+  }
+}
+
+export { MuxedAccount };
+//# sourceMappingURL=muxed_account.js.map

package/lib/esm/base/muxed_account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muxed_account.js","sources":["../../../src/base/muxed_account.ts"],"sourcesContent":["import xdr from \"./xdr.js\";\nimport { Account } from \"./account.js\";\nimport { StrKey } from \"./strkey.js\";\nimport type { TransactionSource } from \"./transaction_source.js\";\nimport {\n  decodeAddressToMuxedAccount,\n  encodeMuxedAccountToAddress,\n  encodeMuxedAccount,\n  extractBaseAddress,\n} from \"./util/decode_encode_muxed_account.js\";\n\nconst MAX_UINT64 = BigInt(\"18446744073709551615\"); // 2^64 - 1\n\nfunction validateUint64Id(id: string): void {\n  let value: bigint;\n\n  try {\n    value = BigInt(id);\n  } catch {\n    throw new Error(`id is not a valid uint64 string: ${id}`);\n  }\n\n  if (value < BigInt(0) || value > MAX_UINT64) {\n    throw new Error(\n      `id value out of range for uint64 [0, ${MAX_UINT64}]: ${id}`,\n    );\n  }\n}\n\n/**\n * Represents a muxed account for transactions and operations.\n *\n * A muxed (or *multiplexed*) account (defined rigorously in\n * [CAP-27](https://docs.digitalworld.global/protocol/cap-27) and briefly in\n * [SEP-23](https://docs.digitalworld.global/protocol/sep-23)) is one that resolves a single\n * Digital World `G...` account to many different underlying IDs.\n *\n * For example, you may have a single Digital World address for accounting purposes:\n *   GA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJVSGZ\n *\n * Yet would like to use it for 4 different family members:\n *   1: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAGZFQ\n *   2: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAALIWQ\n *   3: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAPYHQ\n *   4: MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJUAAAAAAAAAAAAQLQQ\n *\n * This object makes it easy to create muxed accounts from regular accounts,\n * duplicate them, get/set the underlying IDs, etc. without mucking around with\n * the raw XDR.\n *\n * Because muxed accounts are purely an off-chain convention, they all share the\n * sequence number tied to their underlying G... account. Thus, this object\n * *requires* an {@link Account} instance to be passed in, so that muxed\n * instances of an account can collectively modify the sequence number whenever\n * a muxed account is used as the source of a {@link Transaction} with {@link\n * TransactionBuilder}.\n *\n * @see https://docs.digitalworld.global/docs/glossary/muxed-accounts/\n */\nexport class MuxedAccount implements TransactionSource {\n  private account: Account;\n  private _muxedXdr: xdr.MuxedAccount;\n  private _mAddress: string;\n  private _id: string;\n\n  /**\n   * @param baseAccount - the {@link Account} instance representing the\n   *     underlying G... address\n   * @param id - a stringified uint64 value that represents the ID of the\n   *     muxed account\n   */\n  constructor(baseAccount: Account, id: string) {\n    const accountId = baseAccount.accountId();\n\n    if (!StrKey.isValidEd25519PublicKey(accountId)) {\n      throw new Error(\"accountId is invalid\");\n    }\n\n    validateUint64Id(id);\n\n    this.account = baseAccount;\n    this._muxedXdr = encodeMuxedAccount(accountId, id);\n    this._mAddress = encodeMuxedAccountToAddress(this._muxedXdr);\n    this._id = id;\n  }\n\n  /**\n   * Parses an M-address into a MuxedAccount object.\n   *\n   * @param  mAddress    - an M-address to transform\n   * @param  sequenceNum - the sequence number of the underlying {@link\n   *     Account}, to use for the underlying base account {@link\n   *     MuxedAccount.baseAccount}. If you're using the SDK, you can use\n   *     `server.loadAccount` to fetch this if you don't know it.\n   */\n  static fromAddress(mAddress: string, sequenceNum: string): MuxedAccount {\n    const muxedAccount = decodeAddressToMuxedAccount(mAddress);\n    const gAddress = extractBaseAddress(mAddress);\n    const id = muxedAccount.med25519().id().toString();\n\n    return new MuxedAccount(new Account(gAddress, sequenceNum), id);\n  }\n\n  /**\n   * Returns the underlying account object shared among all muxed\n   * accounts with this Digital World address.\n   */\n  baseAccount(): Account {\n    return this.account;\n  }\n\n  /**\n   * Returns the M-address representing this account's (G-address, ID).\n   */\n  accountId(): string {\n    return this._mAddress;\n  }\n\n  /**\n   * Returns the uint64 ID of this muxed account as a string.\n   */\n  id(): string {\n    return this._id;\n  }\n\n  /**\n   * Updates the muxed account's ID, regenerating the M-address accordingly.\n   *\n   * @param id - a stringified uint64 value to set as the new muxed account ID\n   */\n  setId(id: string): MuxedAccount {\n    if (typeof id !== \"string\") {\n      throw new Error(\"id should be a string representing a number (uint64)\");\n    }\n\n    validateUint64Id(id);\n\n    this._muxedXdr.med25519().id(xdr.Uint64.fromString(id));\n    this._mAddress = encodeMuxedAccountToAddress(this._muxedXdr);\n    this._id = id;\n    return this;\n  }\n\n  /**\n   * Returns the stringified sequence number for the underlying account.\n   */\n  sequenceNumber(): string {\n    return this.account.sequenceNumber();\n  }\n\n  /**\n   * Increments the underlying account's sequence number by one.\n   */\n  incrementSequenceNumber(): void {\n    this.account.incrementSequenceNumber();\n  }\n\n  /**\n   * Returns the XDR object representing this muxed account's\n   * G-address and uint64 ID.\n   */\n  toXDRObject(): xdr.MuxedAccount {\n    return this._muxedXdr;\n  }\n\n  /**\n   * Checks whether two muxed accounts are equal by comparing their M-addresses.\n   *\n   * @param otherMuxedAccount - the MuxedAccount to compare against\n   */\n  equals(otherMuxedAccount: MuxedAccount): boolean {\n    return this.accountId() === otherMuxedAccount.accountId();\n  }\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/esm/base/network.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Contains passphrases for Digital World Network:
+ * * `Networks.PUBLIC`: `Digital World Network ; June 2021`
+ * * `Networks.TESTNET`: `Test Digital World Network ; March 2025`
+ */
+export declare enum Networks {
+    PUBLIC = "Digital World Network ; June 2021",
+    TESTNET = "Test Digital World Network ; March 2025"
+}

package/lib/esm/base/network.js

@@ -0,0 +1,8 @@
+var Networks = /* @__PURE__ */ ((Networks2) => {
+  Networks2["PUBLIC"] = "Digital World Network ; June 2021";
+  Networks2["TESTNET"] = "Test Digital World Network ; March 2025";
+  return Networks2;
+})(Networks || {});
+
+export { Networks };
+//# sourceMappingURL=network.js.map

package/lib/esm/base/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sources":["../../../src/base/network.ts"],"sourcesContent":["/**\n * Contains passphrases for Digital World Network:\n * * `Networks.PUBLIC`: `Digital World Network ; June 2021`\n * * `Networks.TESTNET`: `Test Digital World Network ; March 2025`\n */\nexport enum Networks {\n  PUBLIC = \"Digital World Network ; June 2021\",\n  TESTNET = \"Test Digital World Network ; March 2025\",\n}\n"],"names":["Networks"],"mappings":"AAKO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AACL,EAAAA,UAAA,QAAA,CAAA,GAAS,mCAAA;AACT,EAAAA,UAAA,SAAA,CAAA,GAAU,yCAAA;AAFA,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;;;;"}

package/lib/esm/base/numbers/index.d.ts

@@ -0,0 +1,29 @@
+import xdr from "../xdr.js";
+import { XdrLargeInt, type ScIntType } from "./xdr_large_int.js";
+export { Uint128 } from "./uint128.js";
+export { Uint256 } from "./uint256.js";
+export { Int128 } from "./int128.js";
+export { Int256 } from "./int256.js";
+export { ScInt } from "./sc_int.js";
+export { XdrLargeInt };
+export type { ScIntType };
+/**
+ * Transforms an opaque {@link xdr.ScVal} into a native bigint, if possible.
+ *
+ * If you then want to use this in the abstractions provided by this module,
+ * you can pass it to the constructor of {@link XdrLargeInt}.
+ *
+ * @example
+ * ```ts
+ * let scv = contract.call("add", x, y); // assume it returns an xdr.ScVal
+ * let bigi = scValToBigInt(scv);
+ *
+ * new ScInt(bigi);               // if you don't care about types, and
+ * new XdrLargeInt('i128', bigi); // if you do
+ * ```
+ *
+ * @param scv - the XDR smart contract value to convert
+ *
+ * @throws if the `scv` input value doesn't represent an integer
+ */
+export declare function scValToBigInt(scv: xdr.ScVal): bigint;