@digitalworld/digital-world-sdk 16.0.0

package/lib/cjs/base/liquidity_pool_id.js

@@ -0,0 +1,77 @@
+'use strict';
+
+var buffer = require('buffer');
+var curr_generated = require('./generated/curr_generated.js');
+
+class LiquidityPoolId {
+  liquidityPoolId;
+  /**
+   * @param liquidityPoolId - The ID of the liquidity pool in string 'hex'.
+   */
+  constructor(liquidityPoolId) {
+    if (!liquidityPoolId) {
+      throw new Error("liquidityPoolId cannot be empty");
+    }
+    if (!/^[a-f0-9]{64}$/.test(liquidityPoolId)) {
+      throw new Error("Liquidity pool ID is not a valid hash");
+    }
+    this.liquidityPoolId = liquidityPoolId;
+  }
+  /**
+   * Returns a liquidity pool ID object from its xdr.TrustLineAsset representation.
+   * @param tlAssetXdr - The asset XDR object.
+   */
+  static fromOperation(tlAssetXdr) {
+    const assetType = tlAssetXdr.switch();
+    if (assetType === curr_generated.default.AssetType.assetTypePoolShare()) {
+      const liquidityPoolId = tlAssetXdr.liquidityPoolId().toString("hex");
+      return new LiquidityPoolId(liquidityPoolId);
+    }
+    throw new Error(`Invalid asset type: ${assetType.name}`);
+  }
+  /**
+   * Returns the `xdr.TrustLineAsset` object for this liquidity pool ID.
+   *
+   * Note: To convert from {@link Asset | `Asset`} to `xdr.TrustLineAsset` please
+   * refer to the
+   * {@link Asset.toTrustLineXDRObject | `Asset.toTrustLineXDRObject`} method.
+   */
+  toXDRObject() {
+    const xdrPoolId = buffer.Buffer.from(
+      this.liquidityPoolId,
+      "hex"
+    );
+    return curr_generated.default.TrustLineAsset.assetTypePoolShare(xdrPoolId);
+  }
+  /**
+   * Returns the liquidity pool ID as a hex string.
+   */
+  getLiquidityPoolId() {
+    return String(this.liquidityPoolId);
+  }
+  /**
+   * Returns the asset type, always `"liquidity_pool_shares"`.
+   *
+   * @see [Assets concept](https://docs.digitalworld.global/docs/glossary/assets/)
+   */
+  getAssetType() {
+    return "liquidity_pool_shares";
+  }
+  /**
+   * Returns true if this liquidity pool ID equals the given one.
+   *
+   * @param asset - LiquidityPoolId to compare.
+   */
+  equals(asset) {
+    return this.liquidityPoolId === asset.getLiquidityPoolId();
+  }
+  /**
+   * Returns a string representation of this liquidity pool ID.
+   */
+  toString() {
+    return `liquidity_pool:${this.liquidityPoolId}`;
+  }
+}
+
+exports.LiquidityPoolId = LiquidityPoolId;
+//# sourceMappingURL=liquidity_pool_id.js.map

package/lib/cjs/base/liquidity_pool_id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity_pool_id.js","sources":["../../../src/base/liquidity_pool_id.ts"],"sourcesContent":["import xdr from \"./xdr.js\";\n\n/**\n * LiquidityPoolId class represents the asset referenced by a trustline to a\n * liquidity pool.\n */\nexport class LiquidityPoolId {\n  liquidityPoolId: string;\n\n  /**\n   * @param liquidityPoolId - The ID of the liquidity pool in string 'hex'.\n   */\n  constructor(liquidityPoolId: string) {\n    if (!liquidityPoolId) {\n      throw new Error(\"liquidityPoolId cannot be empty\");\n    }\n    if (!/^[a-f0-9]{64}$/.test(liquidityPoolId)) {\n      throw new Error(\"Liquidity pool ID is not a valid hash\");\n    }\n\n    this.liquidityPoolId = liquidityPoolId;\n  }\n\n  /**\n   * Returns a liquidity pool ID object from its xdr.TrustLineAsset representation.\n   * @param tlAssetXdr - The asset XDR object.\n   */\n  static fromOperation(tlAssetXdr: xdr.TrustLineAsset): LiquidityPoolId {\n    const assetType = tlAssetXdr.switch();\n    if (assetType === xdr.AssetType.assetTypePoolShare()) {\n      // tlAssetXdr.liquidityPoolId() is Buffer at runtime\n      const liquidityPoolId = (\n        tlAssetXdr.liquidityPoolId() as unknown as Buffer\n      ).toString(\"hex\");\n      return new LiquidityPoolId(liquidityPoolId);\n    }\n\n    throw new Error(`Invalid asset type: ${assetType.name}`);\n  }\n\n  /**\n   * Returns the `xdr.TrustLineAsset` object for this liquidity pool ID.\n   *\n   * Note: To convert from {@link Asset | `Asset`} to `xdr.TrustLineAsset` please\n   * refer to the\n   * {@link Asset.toTrustLineXDRObject | `Asset.toTrustLineXDRObject`} method.\n   */\n  toXDRObject(): xdr.TrustLineAsset {\n    const xdrPoolId = Buffer.from(\n      this.liquidityPoolId,\n      \"hex\",\n    ) as unknown as xdr.PoolId;\n    return xdr.TrustLineAsset.assetTypePoolShare(xdrPoolId);\n  }\n\n  /**\n   * Returns the liquidity pool ID as a hex string.\n   */\n  getLiquidityPoolId(): string {\n    return String(this.liquidityPoolId);\n  }\n\n  /**\n   * Returns the asset type, always `\"liquidity_pool_shares\"`.\n   *\n   * @see [Assets concept](https://docs.digitalworld.global/docs/glossary/assets/)\n   */\n  getAssetType(): \"liquidity_pool_shares\" {\n    return \"liquidity_pool_shares\";\n  }\n\n  /**\n   * Returns true if this liquidity pool ID equals the given one.\n   *\n   * @param asset - LiquidityPoolId to compare.\n   */\n  equals(asset: LiquidityPoolId): boolean {\n    return this.liquidityPoolId === asset.getLiquidityPoolId();\n  }\n\n  /**\n   * Returns a string representation of this liquidity pool ID.\n   */\n  toString(): string {\n    return `liquidity_pool:${this.liquidityPoolId}`;\n  }\n}\n"],"names":["xdr","Buffer"],"mappings":";;;;;AAMO,MAAM,eAAA,CAAgB;AAAA,EAC3B,eAAA;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,eAAA,EAAyB;AACnC,IAAA,IAAI,CAAC,eAAA,EAAiB;AACpB,MAAA,MAAM,IAAI,MAAM,iCAAiC,CAAA;AAAA,IACnD;AACA,IAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,eAAe,CAAA,EAAG;AAC3C,MAAA,MAAM,IAAI,MAAM,uCAAuC,CAAA;AAAA,IACzD;AAEA,IAAA,IAAA,CAAK,eAAA,GAAkB,eAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,cAAc,UAAA,EAAiD;AACpE,IAAA,MAAM,SAAA,GAAY,WAAW,MAAA,EAAO;AACpC,IAAA,IAAI,SAAA,KAAcA,sBAAA,CAAI,SAAA,CAAU,kBAAA,EAAmB,EAAG;AAEpD,MAAA,MAAM,eAAA,GACJ,UAAA,CAAW,eAAA,EAAgB,CAC3B,SAAS,KAAK,CAAA;AAChB,MAAA,OAAO,IAAI,gBAAgB,eAAe,CAAA;AAAA,IAC5C;AAEA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,SAAA,CAAU,IAAI,CAAA,CAAE,CAAA;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAA,GAAkC;AAChC,IAAA,MAAM,YAAYC,aAAA,CAAO,IAAA;AAAA,MACvB,IAAA,CAAK,eAAA;AAAA,MACL;AAAA,KACF;AACA,IAAA,OAAOD,sBAAA,CAAI,cAAA,CAAe,kBAAA,CAAmB,SAAS,CAAA;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAA,GAA6B;AAC3B,IAAA,OAAO,MAAA,CAAO,KAAK,eAAe,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAA,GAAwC;AACtC,IAAA,OAAO,uBAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,KAAA,EAAiC;AACtC,IAAA,OAAO,IAAA,CAAK,eAAA,KAAoB,KAAA,CAAM,kBAAA,EAAmB;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAmB;AACjB,IAAA,OAAO,CAAA,eAAA,EAAkB,KAAK,eAAe,CAAA,CAAA;AAAA,EAC/C;AACF;;;;"}

package/lib/cjs/base/memo.js

@@ -0,0 +1,237 @@
+'use strict';
+
+var buffer = require('buffer');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js');
+var unsignedHyper = require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js');
+var bignumber = require('./util/bignumber.js');
+var curr_generated = require('./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.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.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.default(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.Buffer.byteLength(value, "utf8") > 28) {
+        throw new Error("Expects string, array or buffer, max 28 bytes");
+      }
+    } else if (buffer.Buffer.isBuffer(value)) {
+      if (value.length > 28) {
+        throw new Error("Expects string, array or buffer, max 28 bytes");
+      }
+    } else {
+      if (!curr_generated.default.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.Buffer.from(value, "hex");
+    } else if (buffer.Buffer.isBuffer(value)) {
+      valueBuffer = buffer.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 curr_generated.default.Memo.memoNone();
+      case MemoID:
+        return curr_generated.default.Memo.memoId(
+          curr_generated.default.Uint64.fromString(
+            unsignedHyper.UnsignedHyper.fromString(this._value).toString()
+          )
+        );
+      case MemoText:
+        return curr_generated.default.Memo.memoText(this._value);
+      case MemoHash:
+        return curr_generated.default.Memo.memoHash(this._value);
+      case MemoReturn:
+        return curr_generated.default.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 curr_generated.default.MemoType.memoId():
+        return Memo.id(object.id().toString());
+      case curr_generated.default.MemoType.memoText():
+        return Memo.text(object.value());
+      case curr_generated.default.MemoType.memoHash():
+        return Memo.hash(object.hash());
+      case curr_generated.default.MemoType.memoReturn():
+        return Memo.return(object.retHash());
+    }
+    if (typeof object.value() === "undefined") {
+      return Memo.none();
+    }
+    throw new Error("Unknown type");
+  }
+}
+
+exports.Memo = Memo;
+exports.MemoHash = MemoHash;
+exports.MemoID = MemoID;
+exports.MemoNone = MemoNone;
+exports.MemoReturn = MemoReturn;
+exports.MemoText = MemoText;
+//# sourceMappingURL=memo.js.map

package/lib/cjs/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":["Buffer","CustomBigNumber","xdr","UnsignedHyper"],"mappings":"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"}

package/lib/cjs/base/muxed_account.js

@@ -0,0 +1,123 @@
+'use strict';
+
+var curr_generated = require('./generated/curr_generated.js');
+var account = require('./account.js');
+var strkey = require('./strkey.js');
+var decode_encode_muxed_account = require('./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.StrKey.isValidEd25519PublicKey(accountId)) {
+      throw new Error("accountId is invalid");
+    }
+    validateUint64Id(id);
+    this.account = baseAccount;
+    this._muxedXdr = decode_encode_muxed_account.encodeMuxedAccount(accountId, id);
+    this._mAddress = decode_encode_muxed_account.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 = decode_encode_muxed_account.decodeAddressToMuxedAccount(mAddress);
+    const gAddress = decode_encode_muxed_account.extractBaseAddress(mAddress);
+    const id = muxedAccount.med25519().id().toString();
+    return new MuxedAccount(new account.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(curr_generated.default.Uint64.fromString(id));
+    this._mAddress = decode_encode_muxed_account.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();
+  }
+}
+
+exports.MuxedAccount = MuxedAccount;
+//# sourceMappingURL=muxed_account.js.map

package/lib/cjs/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":["StrKey","encodeMuxedAccount","encodeMuxedAccountToAddress","decodeAddressToMuxedAccount","extractBaseAddress","Account","xdr"],"mappings":"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"}

package/lib/cjs/base/network.js

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

package/lib/cjs/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/cjs/base/numbers/index.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var xdr_large_int = require('./xdr_large_int.js');
+var uint128 = require('./uint128.js');
+var uint256 = require('./uint256.js');
+var int128 = require('./int128.js');
+var int256 = require('./int256.js');
+
+function scValToBigInt(scv) {
+  const switchName = scv.switch().name;
+  const scIntType = xdr_large_int.XdrLargeInt.getType(switchName);
+  const value = scv.value();
+  if (value === null) {
+    throw TypeError(`unexpected null value for ${switchName}`);
+  }
+  switch (switchName) {
+    case "scvU32":
+    case "scvI32":
+      return BigInt(value);
+    case "scvU64":
+    case "scvI64":
+    case "scvTimepoint":
+    case "scvDuration":
+      if (scIntType === void 0) {
+        throw TypeError(`invalid integer type for ${switchName}`);
+      }
+      return new xdr_large_int.XdrLargeInt(
+        scIntType,
+        value
+      ).toBigInt();
+    case "scvU128":
+    case "scvI128": {
+      if (scIntType === void 0) {
+        throw TypeError(`invalid integer type for ${switchName}`);
+      }
+      const int128Value = value;
+      return new xdr_large_int.XdrLargeInt(scIntType, [
+        int128Value.lo(),
+        int128Value.hi()
+      ]).toBigInt();
+    }
+    case "scvU256":
+    case "scvI256": {
+      if (scIntType === void 0) {
+        throw TypeError(`invalid integer type for ${switchName}`);
+      }
+      const int256Value = value;
+      return new xdr_large_int.XdrLargeInt(scIntType, [
+        int256Value.loLo(),
+        int256Value.loHi(),
+        int256Value.hiLo(),
+        int256Value.hiHi()
+      ]).toBigInt();
+    }
+    default:
+      throw TypeError(`expected integer type, got ${switchName}`);
+  }
+}
+
+exports.XdrLargeInt = xdr_large_int.XdrLargeInt;
+exports.Uint128 = uint128.Uint128;
+exports.Uint256 = uint256.Uint256;
+exports.Int128 = int128.Int128;
+exports.Int256 = int256.Int256;
+exports.scValToBigInt = scValToBigInt;
+//# sourceMappingURL=index.js.map

package/lib/cjs/base/numbers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/base/numbers/index.ts"],"sourcesContent":["import xdr from \"../xdr.js\";\nimport { XdrLargeInt, type ScIntType } from \"./xdr_large_int.js\";\n\nexport { Uint128 } from \"./uint128.js\";\nexport { Uint256 } from \"./uint256.js\";\nexport { Int128 } from \"./int128.js\";\nexport { Int256 } from \"./int256.js\";\nexport { ScInt } from \"./sc_int.js\";\nexport { XdrLargeInt };\nexport type { ScIntType };\n\n/**\n * Transforms an opaque {@link xdr.ScVal} into a native bigint, if possible.\n *\n * If you then want to use this in the abstractions provided by this module,\n * you can pass it to the constructor of {@link XdrLargeInt}.\n *\n * @example\n * ```ts\n * let scv = contract.call(\"add\", x, y); // assume it returns an xdr.ScVal\n * let bigi = scValToBigInt(scv);\n *\n * new ScInt(bigi);               // if you don't care about types, and\n * new XdrLargeInt('i128', bigi); // if you do\n * ```\n *\n * @param scv - the XDR smart contract value to convert\n *\n * @throws if the `scv` input value doesn't represent an integer\n */\nexport function scValToBigInt(scv: xdr.ScVal): bigint {\n  const switchName = scv.switch().name;\n  const scIntType = XdrLargeInt.getType(switchName);\n  const value = scv.value();\n\n  if (value === null) {\n    throw TypeError(`unexpected null value for ${switchName}`);\n  }\n\n  switch (switchName) {\n    case \"scvU32\":\n    case \"scvI32\":\n      return BigInt(value as number);\n\n    case \"scvU64\":\n    case \"scvI64\":\n    case \"scvTimepoint\":\n    case \"scvDuration\":\n      if (scIntType === undefined) {\n        throw TypeError(`invalid integer type for ${switchName}`);\n      }\n      return new XdrLargeInt(\n        scIntType,\n        value as xdr.Int64 | xdr.Uint64,\n      ).toBigInt();\n\n    case \"scvU128\":\n    case \"scvI128\": {\n      if (scIntType === undefined) {\n        throw TypeError(`invalid integer type for ${switchName}`);\n      }\n      const int128Value = value as xdr.Int128Parts | xdr.UInt128Parts;\n      return new XdrLargeInt(scIntType, [\n        int128Value.lo(),\n        int128Value.hi(),\n      ]).toBigInt();\n    }\n\n    case \"scvU256\":\n    case \"scvI256\": {\n      if (scIntType === undefined) {\n        throw TypeError(`invalid integer type for ${switchName}`);\n      }\n      const int256Value = value as xdr.Int256Parts | xdr.UInt256Parts;\n      return new XdrLargeInt(scIntType, [\n        int256Value.loLo(),\n        int256Value.loHi(),\n        int256Value.hiLo(),\n        int256Value.hiHi(),\n      ]).toBigInt();\n    }\n\n    default:\n      throw TypeError(`expected integer type, got ${switchName}`);\n  }\n}\n"],"names":["XdrLargeInt"],"mappings":";;;;;;;;AA8BO,SAAS,cAAc,GAAA,EAAwB;AACpD,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,MAAA,EAAO,CAAE,IAAA;AAChC,EAAA,MAAM,SAAA,GAAYA,yBAAA,CAAY,OAAA,CAAQ,UAAU,CAAA;AAChD,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,EAAM;AAExB,EAAA,IAAI,UAAU,IAAA,EAAM;AAClB,IAAA,MAAM,SAAA,CAAU,CAAA,0BAAA,EAA6B,UAAU,CAAA,CAAE,CAAA;AAAA,EAC3D;AAEA,EAAA,QAAQ,UAAA;AAAY,IAClB,KAAK,QAAA;AAAA,IACL,KAAK,QAAA;AACH,MAAA,OAAO,OAAO,KAAe,CAAA;AAAA,IAE/B,KAAK,QAAA;AAAA,IACL,KAAK,QAAA;AAAA,IACL,KAAK,cAAA;AAAA,IACL,KAAK,aAAA;AACH,MAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,QAAA,MAAM,SAAA,CAAU,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MAC1D;AACA,MAAA,OAAO,IAAIA,yBAAA;AAAA,QACT,SAAA;AAAA,QACA;AAAA,QACA,QAAA,EAAS;AAAA,IAEb,KAAK,SAAA;AAAA,IACL,KAAK,SAAA,EAAW;AACd,MAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,QAAA,MAAM,SAAA,CAAU,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MAC1D;AACA,MAAA,MAAM,WAAA,GAAc,KAAA;AACpB,MAAA,OAAO,IAAIA,0BAAY,SAAA,EAAW;AAAA,QAChC,YAAY,EAAA,EAAG;AAAA,QACf,YAAY,EAAA;AAAG,OAChB,EAAE,QAAA,EAAS;AAAA,IACd;AAAA,IAEA,KAAK,SAAA;AAAA,IACL,KAAK,SAAA,EAAW;AACd,MAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,QAAA,MAAM,SAAA,CAAU,CAAA,yBAAA,EAA4B,UAAU,CAAA,CAAE,CAAA;AAAA,MAC1D;AACA,MAAA,MAAM,WAAA,GAAc,KAAA;AACpB,MAAA,OAAO,IAAIA,0BAAY,SAAA,EAAW;AAAA,QAChC,YAAY,IAAA,EAAK;AAAA,QACjB,YAAY,IAAA,EAAK;AAAA,QACjB,YAAY,IAAA,EAAK;AAAA,QACjB,YAAY,IAAA;AAAK,OAClB,EAAE,QAAA,EAAS;AAAA,IACd;AAAA,IAEA;AACE,MAAA,MAAM,SAAA,CAAU,CAAA,2BAAA,EAA8B,UAAU,CAAA,CAAE,CAAA;AAAA;AAEhE;;;;;;;;;"}

package/lib/cjs/base/numbers/int128.js

@@ -0,0 +1,31 @@
+'use strict';
+
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js');
+var largeInt = require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/large-int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js');
+require('buffer');
+
+class Int128 extends largeInt.LargeInt {
+  /**
+   * Construct a signed 128-bit integer that can be XDR-encoded.
+   *
+   * @param  args - one or more slices to encode
+   *     in big-endian format (i.e. earlier elements are higher bits)
+   */
+  constructor(...args) {
+    super(args);
+  }
+  get unsigned() {
+    return false;
+  }
+  get size() {
+    return 128;
+  }
+}
+Int128.defineIntBoundaries();
+
+exports.Int128 = Int128;
+//# sourceMappingURL=int128.js.map

package/lib/cjs/base/numbers/int128.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"int128.js","sources":["../../../../src/base/numbers/int128.ts"],"sourcesContent":["import { LargeInt } from \"@stellar/js-xdr\";\n\nexport class Int128 extends LargeInt {\n  /**\n   * Construct a signed 128-bit integer that can be XDR-encoded.\n   *\n   * @param  args - one or more slices to encode\n   *     in big-endian format (i.e. earlier elements are higher bits)\n   */\n  constructor(...args: Array<bigint | number | string>) {\n    super(args);\n  }\n\n  get unsigned(): boolean {\n    return false;\n  }\n\n  get size(): number {\n    return 128;\n  }\n}\n\nInt128.defineIntBoundaries();\n"],"names":["LargeInt"],"mappings":";;;;;;;;;;AAEO,MAAM,eAAeA,iBAAA,CAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,eAAe,IAAA,EAAuC;AACpD,IAAA,KAAA,CAAM,IAAI,CAAA;AAAA,EACZ;AAAA,EAEA,IAAI,QAAA,GAAoB;AACtB,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AAEA,MAAA,CAAO,mBAAA,EAAoB;;;;"}

package/lib/cjs/base/numbers/int256.js

@@ -0,0 +1,31 @@
+'use strict';
+
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js');
+var largeInt = require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/large-int.js');
+require('../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js');
+require('buffer');
+
+class Int256 extends largeInt.LargeInt {
+  /**
+   * Construct a signed 256-bit integer that can be XDR-encoded.
+   *
+   * @param args - one or more slices to encode
+   *     in big-endian format (i.e. earlier elements are higher bits)
+   */
+  constructor(...args) {
+    super(args);
+  }
+  get unsigned() {
+    return false;
+  }
+  get size() {
+    return 256;
+  }
+}
+Int256.defineIntBoundaries();
+
+exports.Int256 = Int256;
+//# sourceMappingURL=int256.js.map

package/lib/cjs/base/numbers/int256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"int256.js","sources":["../../../../src/base/numbers/int256.ts"],"sourcesContent":["import { LargeInt } from \"@stellar/js-xdr\";\n\nexport class Int256 extends LargeInt {\n  /**\n   * Construct a signed 256-bit integer that can be XDR-encoded.\n   *\n   * @param args - one or more slices to encode\n   *     in big-endian format (i.e. earlier elements are higher bits)\n   */\n  constructor(...args: Array<bigint | number | string>) {\n    super(args);\n  }\n\n  get unsigned(): boolean {\n    return false;\n  }\n\n  get size(): number {\n    return 256;\n  }\n}\n\nInt256.defineIntBoundaries();\n"],"names":["LargeInt"],"mappings":";;;;;;;;;;AAEO,MAAM,eAAeA,iBAAA,CAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,eAAe,IAAA,EAAuC;AACpD,IAAA,KAAA,CAAM,IAAI,CAAA;AAAA,EACZ;AAAA,EAEA,IAAI,QAAA,GAAoB;AACtB,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AAEA,MAAA,CAAO,mBAAA,EAAoB;;;;"}