@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/esm/base/address.d.ts

@@ -0,0 +1,87 @@
+import xdr from "./xdr.js";
+/**
+ * Create a new Address object.
+ *
+ * `Address` represents a single address in the Digital World Network that can be
+ * inputted to or outputted by a smart contract. An address can represent an
+ * account, muxed account, contract, claimable balance, or a liquidity pool
+ * (the latter two can only be present as the *output* of Core in the form
+ * of an event, never an input to a smart contract).
+ */
+export type AddressType = "account" | "claimableBalance" | "contract" | "liquidityPool" | "muxedAccount";
+export declare class Address {
+    private _type;
+    private _key;
+    /**
+     * @param address - a {@link StrKey} of the address value
+     */
+    constructor(address: string);
+    /**
+     * Parses a string and returns an Address object.
+     *
+     * @param address - The address to parse. ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`
+     */
+    static fromString(address: string): Address;
+    /**
+     * Creates a new account Address object from a buffer of raw bytes.
+     *
+     * @param buffer - The bytes of an address to parse.
+     */
+    static account(buffer: Buffer): Address;
+    /**
+     * Creates a new contract Address object from a buffer of raw bytes.
+     *
+     * @param buffer - The bytes of an address to parse.
+     */
+    static contract(buffer: Buffer): Address;
+    /**
+     * Creates a new claimable balance Address object from a buffer of raw bytes.
+     *
+     * @param buffer - The bytes of a claimable balance ID to parse.
+     */
+    static claimableBalance(buffer: Buffer): Address;
+    /**
+     * Creates a new liquidity pool Address object from a buffer of raw bytes.
+     *
+     * @param buffer - The bytes of an LP ID to parse.
+     */
+    static liquidityPool(buffer: Buffer): Address;
+    /**
+     * Creates a new muxed account Address object from a buffer of raw bytes.
+     *
+     * @param buffer - The bytes of an address to parse.
+     */
+    static muxedAccount(buffer: Buffer): Address;
+    /**
+     * Convert this from an xdr.ScVal type.
+     *
+     * @param scVal - The xdr.ScVal type to parse
+     */
+    static fromScVal(scVal: xdr.ScVal): Address;
+    /**
+     * Convert this from an xdr.ScAddress type
+     *
+     * @param scAddress - The xdr.ScAddress type to parse
+     */
+    static fromScAddress(scAddress: xdr.ScAddress): Address;
+    /**
+     * Serialize an address to string.
+     */
+    toString(): string;
+    /**
+     * Convert this Address to an xdr.ScVal type.
+     */
+    toScVal(): xdr.ScVal;
+    /**
+     * Convert this Address to an xdr.ScAddress type.
+     */
+    toScAddress(): xdr.ScAddress;
+    /**
+     * Return the raw public key bytes for this address.
+     */
+    toBuffer(): Buffer;
+    /**
+     * Return the type of this address.
+     */
+    get type(): AddressType;
+}

package/lib/axios/esm/base/address.js

@@ -0,0 +1,193 @@
+import { Buffer } from 'buffer';
+import { StrKey } from './strkey.js';
+import types from './generated/curr_generated.js';
+
+class Address {
+  _type;
+  _key;
+  /**
+   * @param address - a {@link StrKey} of the address value
+   */
+  constructor(address) {
+    if (StrKey.isValidEd25519PublicKey(address)) {
+      this._type = "account";
+      this._key = StrKey.decodeEd25519PublicKey(address);
+    } else if (StrKey.isValidContract(address)) {
+      this._type = "contract";
+      this._key = StrKey.decodeContract(address);
+    } else if (StrKey.isValidMed25519PublicKey(address)) {
+      this._type = "muxedAccount";
+      this._key = StrKey.decodeMed25519PublicKey(address);
+    } else if (StrKey.isValidClaimableBalance(address)) {
+      this._type = "claimableBalance";
+      this._key = StrKey.decodeClaimableBalance(address);
+    } else if (StrKey.isValidLiquidityPool(address)) {
+      this._type = "liquidityPool";
+      this._key = StrKey.decodeLiquidityPool(address);
+    } else {
+      throw new Error(`Unsupported address type: ${address}`);
+    }
+  }
+  /**
+   * Parses a string and returns an Address object.
+   *
+   * @param address - The address to parse. ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`
+   */
+  static fromString(address) {
+    return new Address(address);
+  }
+  /**
+   * Creates a new account Address object from a buffer of raw bytes.
+   *
+   * @param buffer - The bytes of an address to parse.
+   */
+  static account(buffer) {
+    return new Address(StrKey.encodeEd25519PublicKey(buffer));
+  }
+  /**
+   * Creates a new contract Address object from a buffer of raw bytes.
+   *
+   * @param buffer - The bytes of an address to parse.
+   */
+  static contract(buffer) {
+    return new Address(StrKey.encodeContract(buffer));
+  }
+  /**
+   * Creates a new claimable balance Address object from a buffer of raw bytes.
+   *
+   * @param buffer - The bytes of a claimable balance ID to parse.
+   */
+  static claimableBalance(buffer) {
+    return new Address(StrKey.encodeClaimableBalance(buffer));
+  }
+  /**
+   * Creates a new liquidity pool Address object from a buffer of raw bytes.
+   *
+   * @param buffer - The bytes of an LP ID to parse.
+   */
+  static liquidityPool(buffer) {
+    return new Address(StrKey.encodeLiquidityPool(buffer));
+  }
+  /**
+   * Creates a new muxed account Address object from a buffer of raw bytes.
+   *
+   * @param buffer - The bytes of an address to parse.
+   */
+  static muxedAccount(buffer) {
+    return new Address(StrKey.encodeMed25519PublicKey(buffer));
+  }
+  /**
+   * Convert this from an xdr.ScVal type.
+   *
+   * @param scVal - The xdr.ScVal type to parse
+   */
+  static fromScVal(scVal) {
+    return Address.fromScAddress(scVal.address());
+  }
+  /**
+   * Convert this from an xdr.ScAddress type
+   *
+   * @param scAddress - The xdr.ScAddress type to parse
+   */
+  static fromScAddress(scAddress) {
+    switch (scAddress.switch().value) {
+      case types.ScAddressType.scAddressTypeAccount().value:
+        return Address.account(scAddress.accountId().ed25519());
+      case types.ScAddressType.scAddressTypeContract().value:
+        return Address.contract(scAddress.contractId());
+      case types.ScAddressType.scAddressTypeMuxedAccount().value: {
+        const raw = Buffer.concat([
+          scAddress.muxedAccount().ed25519(),
+          scAddress.muxedAccount().id().toXDR("raw")
+        ]);
+        return Address.muxedAccount(raw);
+      }
+      case types.ScAddressType.scAddressTypeClaimableBalance().value: {
+        const cbi = scAddress.claimableBalanceId();
+        return Address.claimableBalance(
+          Buffer.concat([Buffer.from([cbi.switch().value]), cbi.v0()])
+        );
+      }
+      case types.ScAddressType.scAddressTypeLiquidityPool().value:
+        return Address.liquidityPool(
+          scAddress.liquidityPoolId()
+        );
+      default:
+        throw new Error(`Unsupported address type: ${scAddress.switch().name}`);
+    }
+  }
+  /**
+   * Serialize an address to string.
+   */
+  toString() {
+    switch (this._type) {
+      case "account":
+        return StrKey.encodeEd25519PublicKey(this._key);
+      case "contract":
+        return StrKey.encodeContract(this._key);
+      case "claimableBalance":
+        return StrKey.encodeClaimableBalance(this._key);
+      case "liquidityPool":
+        return StrKey.encodeLiquidityPool(this._key);
+      case "muxedAccount":
+        return StrKey.encodeMed25519PublicKey(this._key);
+      default:
+        throw new Error("Unsupported address type");
+    }
+  }
+  /**
+   * Convert this Address to an xdr.ScVal type.
+   */
+  toScVal() {
+    return types.ScVal.scvAddress(this.toScAddress());
+  }
+  /**
+   * Convert this Address to an xdr.ScAddress type.
+   */
+  toScAddress() {
+    switch (this._type) {
+      case "account":
+        return types.ScAddress.scAddressTypeAccount(
+          types.PublicKey.publicKeyTypeEd25519(this._key)
+        );
+      case "contract":
+        return types.ScAddress.scAddressTypeContract(
+          this._key
+        );
+      case "liquidityPool":
+        return types.ScAddress.scAddressTypeLiquidityPool(
+          this._key
+        );
+      case "claimableBalance":
+        return types.ScAddress.scAddressTypeClaimableBalance(
+          types.ClaimableBalanceId.claimableBalanceIdTypeV0(
+            this._key.subarray(1)
+          )
+        );
+      case "muxedAccount":
+        return types.ScAddress.scAddressTypeMuxedAccount(
+          new types.MuxedEd25519Account({
+            ed25519: this._key.subarray(0, 32),
+            id: types.Uint64.fromXDR(this._key.subarray(32, 40), "raw")
+          })
+        );
+      default:
+        throw new Error("Unsupported address type");
+    }
+  }
+  /**
+   * Return the raw public key bytes for this address.
+   */
+  toBuffer() {
+    return this._key;
+  }
+  /**
+   * Return the type of this address.
+   */
+  get type() {
+    return this._type;
+  }
+}
+
+export { Address };
+//# sourceMappingURL=address.js.map

package/lib/axios/esm/base/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sources":["../../../../src/base/address.ts"],"sourcesContent":["import { StrKey } from \"./strkey.js\";\nimport xdr from \"./xdr.js\";\n\n/**\n * Create a new Address object.\n *\n * `Address` represents a single address in the Digital World Network that can be\n * inputted to or outputted by a smart contract. An address can represent an\n * account, muxed account, contract, claimable balance, or a liquidity pool\n * (the latter two can only be present as the *output* of Core in the form\n * of an event, never an input to a smart contract).\n */\nexport type AddressType =\n  | \"account\"\n  | \"claimableBalance\"\n  | \"contract\"\n  | \"liquidityPool\"\n  | \"muxedAccount\";\n\nexport class Address {\n  private _type: AddressType;\n  private _key: Buffer;\n\n  /**\n   * @param address - a {@link StrKey} of the address value\n   */\n  constructor(address: string) {\n    if (StrKey.isValidEd25519PublicKey(address)) {\n      this._type = \"account\";\n      this._key = StrKey.decodeEd25519PublicKey(address);\n    } else if (StrKey.isValidContract(address)) {\n      this._type = \"contract\";\n      this._key = StrKey.decodeContract(address);\n    } else if (StrKey.isValidMed25519PublicKey(address)) {\n      this._type = \"muxedAccount\";\n      this._key = StrKey.decodeMed25519PublicKey(address);\n    } else if (StrKey.isValidClaimableBalance(address)) {\n      this._type = \"claimableBalance\";\n      this._key = StrKey.decodeClaimableBalance(address);\n    } else if (StrKey.isValidLiquidityPool(address)) {\n      this._type = \"liquidityPool\";\n      this._key = StrKey.decodeLiquidityPool(address);\n    } else {\n      throw new Error(`Unsupported address type: ${address}`);\n    }\n  }\n\n  /**\n   * Parses a string and returns an Address object.\n   *\n   * @param address - The address to parse. ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`\n   */\n  static fromString(address: string): Address {\n    return new Address(address);\n  }\n\n  /**\n   * Creates a new account Address object from a buffer of raw bytes.\n   *\n   * @param buffer - The bytes of an address to parse.\n   */\n  static account(buffer: Buffer): Address {\n    return new Address(StrKey.encodeEd25519PublicKey(buffer));\n  }\n\n  /**\n   * Creates a new contract Address object from a buffer of raw bytes.\n   *\n   * @param buffer - The bytes of an address to parse.\n   */\n  static contract(buffer: Buffer): Address {\n    return new Address(StrKey.encodeContract(buffer));\n  }\n\n  /**\n   * Creates a new claimable balance Address object from a buffer of raw bytes.\n   *\n   * @param buffer - The bytes of a claimable balance ID to parse.\n   */\n  static claimableBalance(buffer: Buffer): Address {\n    return new Address(StrKey.encodeClaimableBalance(buffer));\n  }\n\n  /**\n   * Creates a new liquidity pool Address object from a buffer of raw bytes.\n   *\n   * @param buffer - The bytes of an LP ID to parse.\n   */\n  static liquidityPool(buffer: Buffer): Address {\n    return new Address(StrKey.encodeLiquidityPool(buffer));\n  }\n\n  /**\n   * Creates a new muxed account Address object from a buffer of raw bytes.\n   *\n   * @param buffer - The bytes of an address to parse.\n   */\n  static muxedAccount(buffer: Buffer): Address {\n    return new Address(StrKey.encodeMed25519PublicKey(buffer));\n  }\n\n  /**\n   * Convert this from an xdr.ScVal type.\n   *\n   * @param scVal - The xdr.ScVal type to parse\n   */\n  static fromScVal(scVal: xdr.ScVal): Address {\n    return Address.fromScAddress(scVal.address());\n  }\n\n  /**\n   * Convert this from an xdr.ScAddress type\n   *\n   * @param scAddress - The xdr.ScAddress type to parse\n   */\n  static fromScAddress(scAddress: xdr.ScAddress): Address {\n    switch (scAddress.switch().value) {\n      case xdr.ScAddressType.scAddressTypeAccount().value:\n        return Address.account(scAddress.accountId().ed25519());\n      case xdr.ScAddressType.scAddressTypeContract().value:\n        return Address.contract(scAddress.contractId() as unknown as Buffer);\n      case xdr.ScAddressType.scAddressTypeMuxedAccount().value: {\n        const raw = Buffer.concat([\n          scAddress.muxedAccount().ed25519(),\n          scAddress.muxedAccount().id().toXDR(\"raw\"),\n        ]);\n        return Address.muxedAccount(raw);\n      }\n      case xdr.ScAddressType.scAddressTypeClaimableBalance().value: {\n        const cbi = scAddress.claimableBalanceId();\n        return Address.claimableBalance(\n          Buffer.concat([Buffer.from([cbi.switch().value]), cbi.v0()]),\n        );\n      }\n      case xdr.ScAddressType.scAddressTypeLiquidityPool().value:\n        return Address.liquidityPool(\n          scAddress.liquidityPoolId() as unknown as Buffer,\n        );\n      default:\n        throw new Error(`Unsupported address type: ${scAddress.switch().name}`);\n    }\n  }\n\n  /**\n   * Serialize an address to string.\n   */\n  toString(): string {\n    switch (this._type) {\n      case \"account\":\n        return StrKey.encodeEd25519PublicKey(this._key);\n      case \"contract\":\n        return StrKey.encodeContract(this._key);\n      case \"claimableBalance\":\n        return StrKey.encodeClaimableBalance(this._key);\n      case \"liquidityPool\":\n        return StrKey.encodeLiquidityPool(this._key);\n      case \"muxedAccount\":\n        return StrKey.encodeMed25519PublicKey(this._key);\n      default:\n        throw new Error(\"Unsupported address type\");\n    }\n  }\n\n  /**\n   * Convert this Address to an xdr.ScVal type.\n   */\n  toScVal(): xdr.ScVal {\n    return xdr.ScVal.scvAddress(this.toScAddress());\n  }\n\n  /**\n   * Convert this Address to an xdr.ScAddress type.\n   */\n  toScAddress(): xdr.ScAddress {\n    switch (this._type) {\n      case \"account\":\n        return xdr.ScAddress.scAddressTypeAccount(\n          xdr.PublicKey.publicKeyTypeEd25519(this._key),\n        );\n      case \"contract\":\n        return xdr.ScAddress.scAddressTypeContract(\n          this._key as unknown as xdr.Hash,\n        );\n      case \"liquidityPool\":\n        return xdr.ScAddress.scAddressTypeLiquidityPool(\n          this._key as unknown as xdr.Hash,\n        );\n\n      case \"claimableBalance\":\n        return xdr.ScAddress.scAddressTypeClaimableBalance(\n          xdr.ClaimableBalanceId.claimableBalanceIdTypeV0(\n            this._key.subarray(1),\n          ),\n        );\n\n      case \"muxedAccount\":\n        return xdr.ScAddress.scAddressTypeMuxedAccount(\n          new xdr.MuxedEd25519Account({\n            ed25519: this._key.subarray(0, 32),\n            id: xdr.Uint64.fromXDR(this._key.subarray(32, 40), \"raw\"),\n          }),\n        );\n\n      default:\n        throw new Error(\"Unsupported address type\");\n    }\n  }\n\n  /**\n   * Return the raw public key bytes for this address.\n   */\n  toBuffer(): Buffer {\n    return this._key;\n  }\n\n  /**\n   * Return the type of this address.\n   */\n  get type(): AddressType {\n    return this._type;\n  }\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/axios/esm/base/asset.d.ts

@@ -0,0 +1,118 @@
+import xdr from "./xdr.js";
+export declare const AssetType: {
+    readonly native: "native";
+    readonly credit4: "credit_alphanum4";
+    readonly credit12: "credit_alphanum12";
+    readonly liquidityPoolShares: "liquidity_pool_shares";
+};
+export type AssetType = (typeof AssetType)[keyof typeof AssetType];
+export declare namespace AssetType {
+    type native = "native";
+    type credit4 = "credit_alphanum4";
+    type credit12 = "credit_alphanum12";
+    type liquidityPoolShares = "liquidity_pool_shares";
+}
+/**
+ * Asset class represents an asset, either the native asset (`NATIVE`)
+ * or an asset code / issuer account ID pair.
+ *
+ * An asset describes an asset code and issuer pair. In the case of the native
+ * asset NATIVE, the issuer will be undefined.
+ */
+export declare class Asset {
+    /** The asset code. */
+    readonly code: string;
+    /** The account ID of the issuer. Undefined for the native asset. */
+    readonly issuer: string | undefined;
+    /**
+     * @param code - The asset code.
+     * @param issuer - The account ID of the issuer.
+     */
+    constructor(code: string, issuer?: string);
+    /**
+     * Returns an asset object for the native asset.
+     */
+    static native(): Asset;
+    /**
+     * Returns an asset object from its XDR object representation.
+     * @param assetXdr - The asset xdr object.
+     */
+    static fromOperation(assetXdr: xdr.Asset): Asset;
+    /**
+     * Returns the xdr.Asset object for this asset.
+     */
+    toXDRObject(): xdr.Asset;
+    /**
+     * Returns the xdr.ChangeTrustAsset object for this asset.
+     */
+    toChangeTrustXDRObject(): xdr.ChangeTrustAsset;
+    /**
+     * Returns the xdr.TrustLineAsset object for this asset.
+     */
+    toTrustLineXDRObject(): xdr.TrustLineAsset;
+    /**
+     * Returns the would-be contract ID (`C...` format) for this asset on a given
+     * network.
+     *
+     * @param networkPassphrase - indicates which network the contract
+     *    ID should refer to, since every network will have a unique ID for the
+     *    same contract (see {@link Networks} for options)
+     *
+     * **Warning:** This makes no guarantee that this contract actually *exists*.
+     */
+    contractId(networkPassphrase: string): string;
+    /**
+     * Returns the xdr object for this asset.
+     * @param xdrAsset - The xdr asset constructor.
+     */
+    private _toXDRObject;
+    /**
+     * Returns the asset code
+     */
+    getCode(): string;
+    /**
+     * Returns the asset issuer
+     */
+    getIssuer(): string | undefined;
+    /**
+     * @see [Assets concept](https://docs.digitalworld.global/docs/glossary/assets/)
+     * Returns the asset type. Can be one of following types:
+     *
+     *  - `native`,
+     *  - `credit_alphanum4`,
+     *  - `credit_alphanum12`
+     * @throws Throws `Error` if asset type is unsupported.
+     */
+    getAssetType(): AssetType;
+    /**
+     * Returns the raw XDR representation of the asset type
+     */
+    getRawAssetType(): xdr.AssetType;
+    /**
+     * Returns true if this asset object is the native asset.
+     */
+    isNative(): boolean;
+    /**
+     * Returns true if this asset equals the given asset.
+     *
+     * @param asset - Asset to compare
+     */
+    equals(asset: Asset): boolean;
+    /**
+     * Returns a string representation of this asset.
+     *
+     * Native assets return `"native"`. Non-native assets return `"code:issuer"`.
+     */
+    toString(): string;
+    /**
+     * Compares two assets according to the criteria:
+     *
+     *  1. First compare the type (`native < alphanum4 < alphanum12`).
+     *  2. If the types are equal, compare the assets codes.
+     *  3. If the asset codes are equal, compare the issuers.
+     *
+     * @param assetA - the first asset
+     * @param assetB - the second asset
+     */
+    static compare(assetA: Asset, assetB: Asset): -1 | 0 | 1;
+}

package/lib/axios/esm/base/asset.js

@@ -0,0 +1,258 @@
+import { Buffer } from 'buffer';
+import { trimEnd } from './util/util.js';
+import types from './generated/curr_generated.js';
+import { Keypair } from './keypair.js';
+import { StrKey } from './strkey.js';
+import { hash } from './hashing.js';
+
+const AssetType = {
+  native: "native",
+  credit4: "credit_alphanum4",
+  credit12: "credit_alphanum12",
+  liquidityPoolShares: "liquidity_pool_shares"
+};
+function asciiCompare(a, b) {
+  return Buffer.compare(Buffer.from(a, "ascii"), Buffer.from(b, "ascii"));
+}
+class Asset {
+  /** The asset code. */
+  code;
+  /** The account ID of the issuer. Undefined for the native asset. */
+  issuer;
+  /**
+   * @param code - The asset code.
+   * @param issuer - The account ID of the issuer.
+   */
+  constructor(code, issuer) {
+    if (!/^[a-zA-Z0-9]{1,12}$/.test(code)) {
+      throw new Error(
+        "Asset code is invalid (maximum alphanumeric, 12 characters at max)"
+      );
+    }
+    if (String(code).toLowerCase() !== "native" && !issuer) {
+      throw new Error("Issuer cannot be null");
+    }
+    if (issuer && !StrKey.isValidEd25519PublicKey(issuer)) {
+      throw new Error("Issuer is invalid");
+    }
+    if (String(code).toLowerCase() === "native") {
+      this.code = "NATIVE";
+    } else {
+      this.code = code;
+    }
+    this.issuer = issuer;
+  }
+  /**
+   * Returns an asset object for the native asset.
+   */
+  static native() {
+    return new Asset("NATIVE");
+  }
+  /**
+   * Returns an asset object from its XDR object representation.
+   * @param assetXdr - The asset xdr object.
+   */
+  static fromOperation(assetXdr) {
+    let anum;
+    let code;
+    let issuer;
+    switch (assetXdr.switch()) {
+      case types.AssetType.assetTypeNative():
+        return this.native();
+      case types.AssetType.assetTypeCreditAlphanum4():
+        anum = assetXdr.alphaNum4();
+        issuer = StrKey.encodeEd25519PublicKey(anum.issuer().ed25519());
+        code = trimEnd(anum.assetCode().toString(), "\0");
+        return new this(code, issuer);
+      case types.AssetType.assetTypeCreditAlphanum12():
+        anum = assetXdr.alphaNum12();
+        issuer = StrKey.encodeEd25519PublicKey(anum.issuer().ed25519());
+        code = trimEnd(anum.assetCode().toString(), "\0");
+        return new this(code, issuer);
+      default:
+        throw new Error(`Invalid asset type: ${assetXdr.switch().name}`);
+    }
+  }
+  /**
+   * Returns the xdr.Asset object for this asset.
+   */
+  toXDRObject() {
+    return this._toXDRObject(types.Asset);
+  }
+  /**
+   * Returns the xdr.ChangeTrustAsset object for this asset.
+   */
+  toChangeTrustXDRObject() {
+    return this._toXDRObject(types.ChangeTrustAsset);
+  }
+  /**
+   * Returns the xdr.TrustLineAsset object for this asset.
+   */
+  toTrustLineXDRObject() {
+    return this._toXDRObject(types.TrustLineAsset);
+  }
+  /**
+   * Returns the would-be contract ID (`C...` format) for this asset on a given
+   * network.
+   *
+   * @param networkPassphrase - indicates which network the contract
+   *    ID should refer to, since every network will have a unique ID for the
+   *    same contract (see {@link Networks} for options)
+   *
+   * **Warning:** This makes no guarantee that this contract actually *exists*.
+   */
+  contractId(networkPassphrase) {
+    const networkId = hash(Buffer.from(networkPassphrase));
+    const preimage = types.HashIdPreimage.envelopeTypeContractId(
+      new types.HashIdPreimageContractId({
+        networkId,
+        contractIdPreimage: types.ContractIdPreimage.contractIdPreimageFromAsset(
+          this.toXDRObject()
+        )
+      })
+    );
+    return StrKey.encodeContract(hash(preimage.toXDR()));
+  }
+  /**
+   * Returns the xdr object for this asset.
+   * @param xdrAsset - The xdr asset constructor.
+   */
+  _toXDRObject(xdrAsset) {
+    if (this.isNative()) {
+      return xdrAsset.assetTypeNative();
+    }
+    if (!this.issuer) {
+      throw new Error("Issuer cannot be null for non-native asset");
+    }
+    let xdrType;
+    let xdrTypeString;
+    if (this.code.length <= 4) {
+      xdrType = types.AlphaNum4;
+      xdrTypeString = "assetTypeCreditAlphanum4";
+    } else {
+      xdrType = types.AlphaNum12;
+      xdrTypeString = "assetTypeCreditAlphanum12";
+    }
+    const padLength = this.code.length <= 4 ? 4 : 12;
+    const paddedCode = this.code.padEnd(padLength, "\0");
+    const assetType = new xdrType({
+      assetCode: paddedCode,
+      issuer: Keypair.fromPublicKey(this.issuer).xdrAccountId()
+    });
+    return new xdrAsset(xdrTypeString, assetType);
+  }
+  /**
+   * Returns the asset code
+   */
+  getCode() {
+    return String(this.code);
+  }
+  /**
+   * Returns the asset issuer
+   */
+  getIssuer() {
+    if (this.issuer === void 0) {
+      return void 0;
+    }
+    return String(this.issuer);
+  }
+  /**
+   * @see [Assets concept](https://docs.digitalworld.global/docs/glossary/assets/)
+   * Returns the asset type. Can be one of following types:
+   *
+   *  - `native`,
+   *  - `credit_alphanum4`,
+   *  - `credit_alphanum12`
+   * @throws Throws `Error` if asset type is unsupported.
+   */
+  getAssetType() {
+    switch (this.getRawAssetType().value) {
+      case types.AssetType.assetTypeNative().value:
+        return AssetType.native;
+      case types.AssetType.assetTypeCreditAlphanum4().value:
+        return AssetType.credit4;
+      case types.AssetType.assetTypeCreditAlphanum12().value:
+        return AssetType.credit12;
+      default:
+        throw new Error(
+          "Supported asset types are: native, credit_alphanum4, credit_alphanum12"
+        );
+    }
+  }
+  /**
+   * Returns the raw XDR representation of the asset type
+   */
+  getRawAssetType() {
+    if (this.isNative()) {
+      return types.AssetType.assetTypeNative();
+    }
+    if (this.code.length <= 4) {
+      return types.AssetType.assetTypeCreditAlphanum4();
+    }
+    return types.AssetType.assetTypeCreditAlphanum12();
+  }
+  /**
+   * Returns true if this asset object is the native asset.
+   */
+  isNative() {
+    return !this.issuer;
+  }
+  /**
+   * Returns true if this asset equals the given asset.
+   *
+   * @param asset - Asset to compare
+   */
+  equals(asset) {
+    return this.code === asset.getCode() && this.issuer === asset.getIssuer();
+  }
+  /**
+   * Returns a string representation of this asset.
+   *
+   * Native assets return `"native"`. Non-native assets return `"code:issuer"`.
+   */
+  toString() {
+    if (this.isNative()) {
+      return "native";
+    }
+    return `${this.getCode()}:${this.getIssuer()}`;
+  }
+  /**
+   * Compares two assets according to the criteria:
+   *
+   *  1. First compare the type (`native < alphanum4 < alphanum12`).
+   *  2. If the types are equal, compare the assets codes.
+   *  3. If the asset codes are equal, compare the issuers.
+   *
+   * @param assetA - the first asset
+   * @param assetB - the second asset
+   */
+  static compare(assetA, assetB) {
+    if (!assetA || !(assetA instanceof Asset)) {
+      throw new Error("assetA is invalid");
+    }
+    if (!assetB || !(assetB instanceof Asset)) {
+      throw new Error("assetB is invalid");
+    }
+    if (assetA.equals(assetB)) {
+      return 0;
+    }
+    const xdrAtype = assetA.getRawAssetType().value;
+    const xdrBtype = assetB.getRawAssetType().value;
+    if (xdrAtype !== xdrBtype) {
+      return xdrAtype < xdrBtype ? -1 : 1;
+    }
+    const result = asciiCompare(assetA.getCode(), assetB.getCode());
+    if (result !== 0) {
+      return result;
+    }
+    const issuerA = assetA.getIssuer();
+    const issuerB = assetB.getIssuer();
+    if (issuerA === void 0 || issuerB === void 0) {
+      throw new Error("Issuer is undefined for non-native asset");
+    }
+    return asciiCompare(issuerA, issuerB);
+  }
+}
+
+export { Asset, AssetType };
+//# sourceMappingURL=asset.js.map