@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/esm/webauth/index.js

@@ -0,0 +1,4 @@
+export { gatherTxSigners, verifyTxSignedBy } from './utils.js';
+export { InvalidChallengeError } from './errors.js';
+export { buildChallengeTx, readChallengeTx, verifyChallengeTxSigners, verifyChallengeTxThreshold } from './challenge_transaction.js';
+//# sourceMappingURL=index.js.map

package/lib/axios/esm/webauth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/lib/axios/esm/webauth/utils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Digital World Web Authentication
+ * @see {@link https://docs.digitalworld.global/protocol/sep-10 | SEP-10 Specification}
+ */
+import { FeeBumpTransaction, Transaction } from "../base/index.js";
+/**
+ * Checks if a transaction has been signed by one or more of the given signers,
+ * returning a list of non-repeated signers that were found to have signed the
+ * given transaction.
+ *
+ * @param transaction - The signed transaction.
+ * @param signers - The signer's public keys.
+ * @returns A list of signers that were found to have signed
+ *    the transaction.
+ *
+ * @example
+ * ```ts
+ * let keypair1 = Keypair.random();
+ * let keypair2 = Keypair.random();
+ * const account = new StellarSdk.Account(keypair1.publicKey(), "-1");
+ *
+ * const transaction = new TransactionBuilder(account, { fee: 100 })
+ *    .setTimeout(30)
+ *    .build();
+ *
+ * transaction.sign(keypair1, keypair2)
+ * WebAuth.gatherTxSigners(transaction, [keypair1.publicKey(), keypair2.publicKey()])
+ * ```
+ */
+export declare function gatherTxSigners(transaction: FeeBumpTransaction | Transaction, signers: string[]): string[];
+/**
+ * Verifies if a transaction was signed by the given account id.
+ *
+ * @param transaction - The signed transaction.
+ * @param accountID - The signer's public key.
+ * @returns Whether or not `accountID` was found to have signed the
+ *    transaction.
+ *
+ * @example
+ * ```ts
+ * let keypair = Keypair.random();
+ * const account = new StellarSdk.Account(keypair.publicKey(), "-1");
+ *
+ * const transaction = new TransactionBuilder(account, { fee: 100 })
+ *    .setTimeout(30)
+ *    .build();
+ *
+ * transaction.sign(keypair)
+ * WebAuth.verifyTxSignedBy(transaction, keypair.publicKey())
+ * ```
+ */
+export declare function verifyTxSignedBy(transaction: FeeBumpTransaction | Transaction, accountID: string): boolean;
+/**
+ * A parsed and validated challenge transaction, and some of its constituent details.
+ */
+export type ChallengeTxDetails = {
+    /** The challenge transaction. */
+    tx: Transaction;
+    /** The Digital World public key (master key) used to sign the Manage Data operation. */
+    clientAccountId: string;
+    /** The matched home domain. */
+    matchedHomeDomain: string;
+    /** The memo attached to the transaction, which will be null if not present */
+    memo?: string;
+};

package/lib/axios/esm/webauth/utils.js

@@ -0,0 +1,58 @@
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
+import 'buffer';
+import '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import { Keypair } from '../base/keypair.js';
+import 'base32.js';
+import '../base/util/continued_fraction.js';
+import '../base/util/bignumber.js';
+import '../base/transaction_builder.js';
+import '../base/muxed_account.js';
+import '../base/scval.js';
+import '../base/numbers/uint128.js';
+import '../base/numbers/uint256.js';
+import '../base/numbers/int128.js';
+import '../base/numbers/int256.js';
+import { InvalidChallengeError } from './errors.js';
+
+function gatherTxSigners(transaction, signers) {
+  const hashedSignatureBase = transaction.hash();
+  const txSignatures = [...transaction.signatures];
+  const signersFound = /* @__PURE__ */ new Set();
+  for (const signer of signers) {
+    if (txSignatures.length === 0) {
+      break;
+    }
+    let keypair;
+    try {
+      keypair = Keypair.fromPublicKey(signer);
+    } catch (err) {
+      throw new InvalidChallengeError(
+        `Signer is not a valid address: ${err.message}`
+      );
+    }
+    for (let i = 0; i < txSignatures.length; i++) {
+      const decSig = txSignatures[i];
+      if (!decSig.hint().equals(keypair.signatureHint())) {
+        continue;
+      }
+      if (keypair.verify(hashedSignatureBase, decSig.signature())) {
+        signersFound.add(signer);
+        txSignatures.splice(i, 1);
+        break;
+      }
+    }
+  }
+  return Array.from(signersFound);
+}
+function verifyTxSignedBy(transaction, accountID) {
+  return gatherTxSigners(transaction, [accountID]).length !== 0;
+}
+
+export { gatherTxSigners, verifyTxSignedBy };
+//# sourceMappingURL=utils.js.map

package/lib/axios/esm/webauth/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../src/webauth/utils.ts"],"sourcesContent":["/**\n * Digital World Web Authentication\n * @see {@link https://docs.digitalworld.global/protocol/sep-10 | SEP-10 Specification}\n */\n\nimport { FeeBumpTransaction, Keypair, Transaction } from \"../base/index.js\";\nimport { InvalidChallengeError } from \"./errors.js\";\n/**\n * Checks if a transaction has been signed by one or more of the given signers,\n * returning a list of non-repeated signers that were found to have signed the\n * given transaction.\n *\n * @param transaction - The signed transaction.\n * @param signers - The signer's public keys.\n * @returns A list of signers that were found to have signed\n *    the transaction.\n *\n * @example\n * ```ts\n * let keypair1 = Keypair.random();\n * let keypair2 = Keypair.random();\n * const account = new StellarSdk.Account(keypair1.publicKey(), \"-1\");\n *\n * const transaction = new TransactionBuilder(account, { fee: 100 })\n *    .setTimeout(30)\n *    .build();\n *\n * transaction.sign(keypair1, keypair2)\n * WebAuth.gatherTxSigners(transaction, [keypair1.publicKey(), keypair2.publicKey()])\n * ```\n */\nexport function gatherTxSigners(\n  transaction: FeeBumpTransaction | Transaction,\n  signers: string[],\n): string[] {\n  const hashedSignatureBase = transaction.hash();\n\n  const txSignatures = [...transaction.signatures]; // shallow copy for safe splicing\n  const signersFound = new Set<string>();\n\n  for (const signer of signers) {\n    if (txSignatures.length === 0) {\n      break;\n    }\n\n    let keypair: Keypair;\n    try {\n      keypair = Keypair.fromPublicKey(signer); // This can throw a few different errors\n    } catch (err: any) {\n      throw new InvalidChallengeError(\n        `Signer is not a valid address: ${err.message}`,\n      );\n    }\n\n    for (let i = 0; i < txSignatures.length; i++) {\n      const decSig = txSignatures[i];\n\n      if (!decSig.hint().equals(keypair.signatureHint())) {\n        continue;\n      }\n\n      if (keypair.verify(hashedSignatureBase, decSig.signature())) {\n        signersFound.add(signer);\n        txSignatures.splice(i, 1);\n        break;\n      }\n    }\n  }\n\n  return Array.from(signersFound);\n}\n\n/**\n * Verifies if a transaction was signed by the given account id.\n *\n * @param transaction - The signed transaction.\n * @param accountID - The signer's public key.\n * @returns Whether or not `accountID` was found to have signed the\n *    transaction.\n *\n * @example\n * ```ts\n * let keypair = Keypair.random();\n * const account = new StellarSdk.Account(keypair.publicKey(), \"-1\");\n *\n * const transaction = new TransactionBuilder(account, { fee: 100 })\n *    .setTimeout(30)\n *    .build();\n *\n * transaction.sign(keypair)\n * WebAuth.verifyTxSignedBy(transaction, keypair.publicKey())\n * ```\n */\nexport function verifyTxSignedBy(\n  transaction: FeeBumpTransaction | Transaction,\n  accountID: string,\n): boolean {\n  return gatherTxSigners(transaction, [accountID]).length !== 0;\n}\n\n/**\n * A parsed and validated challenge transaction, and some of its constituent details.\n */\nexport type ChallengeTxDetails = {\n  /** The challenge transaction. */\n  tx: Transaction;\n  /** The Digital World public key (master key) used to sign the Manage Data operation. */\n  clientAccountId: string;\n  /** The matched home domain. */\n  matchedHomeDomain: string;\n  /** The memo attached to the transaction, which will be null if not present */\n  memo?: string;\n};\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA+BO,SAAS,eAAA,CACd,aACA,OAAA,EACU;AACV,EAAA,MAAM,mBAAA,GAAsB,YAAY,IAAA,EAAK;AAE7C,EAAA,MAAM,YAAA,GAAe,CAAC,GAAG,WAAA,CAAY,UAAU,CAAA;AAC/C,EAAA,MAAM,YAAA,uBAAmB,GAAA,EAAY;AAErC,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,IAAA,IAAI,YAAA,CAAa,WAAW,CAAA,EAAG;AAC7B,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,OAAA;AACJ,IAAA,IAAI;AACF,MAAA,OAAA,GAAU,OAAA,CAAQ,cAAc,MAAM,CAAA;AAAA,IACxC,SAAS,GAAA,EAAU;AACjB,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,CAAA,+BAAA,EAAkC,IAAI,OAAO,CAAA;AAAA,OAC/C;AAAA,IACF;AAEA,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,YAAA,CAAa,QAAQ,CAAA,EAAA,EAAK;AAC5C,MAAA,MAAM,MAAA,GAAS,aAAa,CAAC,CAAA;AAE7B,MAAA,IAAI,CAAC,OAAO,IAAA,EAAK,CAAE,OAAO,OAAA,CAAQ,aAAA,EAAe,CAAA,EAAG;AAClD,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,QAAQ,MAAA,CAAO,mBAAA,EAAqB,MAAA,CAAO,SAAA,EAAW,CAAA,EAAG;AAC3D,QAAA,YAAA,CAAa,IAAI,MAAM,CAAA;AACvB,QAAA,YAAA,CAAa,MAAA,CAAO,GAAG,CAAC,CAAA;AACxB,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,YAAY,CAAA;AAChC;AAuBO,SAAS,gBAAA,CACd,aACA,SAAA,EACS;AACT,EAAA,OAAO,gBAAgB,WAAA,EAAa,CAAC,SAAS,CAAC,EAAE,MAAA,KAAW,CAAA;AAC9D;;;;"}

package/lib/cjs/base/account.js

@@ -0,0 +1,60 @@
+'use strict';
+
+var bignumber = require('./util/bignumber.js');
+var strkey = require('./strkey.js');
+
+class Account {
+  _accountId;
+  sequence;
+  /**
+   * @param accountId - ID of the account (ex.
+   *     `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`). If you
+   *     provide a muxed account address, this will throw; use {@link
+   *     MuxedAccount} instead.
+   * @param sequence - current sequence number of the account
+   */
+  constructor(accountId, sequence) {
+    if (strkey.StrKey.isValidMed25519PublicKey(accountId)) {
+      throw new Error("accountId is an M-address; use MuxedAccount instead");
+    }
+    if (!strkey.StrKey.isValidEd25519PublicKey(accountId)) {
+      throw new Error("accountId is invalid");
+    }
+    if (!(typeof sequence === "string")) {
+      throw new Error("sequence must be of type string");
+    }
+    let parsed;
+    try {
+      parsed = new bignumber.default(sequence);
+    } catch {
+      throw new Error("sequence is not a valid number");
+    }
+    if (parsed.isNaN()) {
+      throw new Error("sequence is not a valid number");
+    }
+    this._accountId = accountId;
+    this.sequence = parsed;
+  }
+  /**
+   * Returns Digital World account ID, ex.
+   * `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`.
+   */
+  accountId() {
+    return this._accountId;
+  }
+  /**
+   * Returns sequence number for the account as a string
+   */
+  sequenceNumber() {
+    return this.sequence.toString();
+  }
+  /**
+   * Increments sequence number in this object by one.
+   */
+  incrementSequenceNumber() {
+    this.sequence = this.sequence.plus(1);
+  }
+}
+
+exports.Account = Account;
+//# sourceMappingURL=account.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sources":["../../../src/base/account.ts"],"sourcesContent":["import CustomBigNumber from \"./util/bignumber.js\";\nimport type { BigNumber } from \"./util/bignumber.js\";\n\nimport { StrKey } from \"./strkey.js\";\nimport type { TransactionSource } from \"./transaction_source.js\";\n\n/**\n * Create a new Account object.\n *\n * `Account` represents a single account in the Digital World Network and its sequence\n * number. Account tracks the sequence number as it is used by {@link\n * TransactionBuilder}. See\n * [Accounts](https://docs.digitalworld.global/docs/glossary/accounts/) for\n * more information about how accounts work in the Digital World Network.\n */\nexport class Account implements TransactionSource {\n  private _accountId: string;\n  private sequence: BigNumber;\n\n  /**\n   * @param accountId - ID of the account (ex.\n   *     `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`). If you\n   *     provide a muxed account address, this will throw; use {@link\n   *     MuxedAccount} instead.\n   * @param sequence - current sequence number of the account\n   */\n  constructor(accountId: string, sequence: string) {\n    if (StrKey.isValidMed25519PublicKey(accountId)) {\n      throw new Error(\"accountId is an M-address; use MuxedAccount instead\");\n    }\n\n    if (!StrKey.isValidEd25519PublicKey(accountId)) {\n      throw new Error(\"accountId is invalid\");\n    }\n    if (!(typeof sequence === \"string\")) {\n      throw new Error(\"sequence must be of type string\");\n    }\n\n    let parsed: BigNumber;\n    try {\n      parsed = new CustomBigNumber(sequence);\n    } catch {\n      throw new Error(\"sequence is not a valid number\");\n    }\n\n    if (parsed.isNaN()) {\n      throw new Error(\"sequence is not a valid number\");\n    }\n\n    this._accountId = accountId;\n    this.sequence = parsed;\n  }\n\n  /**\n   * Returns Digital World account ID, ex.\n   * `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`.\n   */\n  accountId(): string {\n    return this._accountId;\n  }\n\n  /**\n   * Returns sequence number for the account as a string\n   */\n  sequenceNumber(): string {\n    return this.sequence.toString();\n  }\n\n  /**\n   * Increments sequence number in this object by one.\n   */\n  incrementSequenceNumber(): void {\n    this.sequence = this.sequence.plus(1);\n  }\n}\n"],"names":["StrKey","CustomBigNumber"],"mappings":";;;;;AAeO,MAAM,OAAA,CAAqC;AAAA,EACxC,UAAA;AAAA,EACA,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASR,WAAA,CAAY,WAAmB,QAAA,EAAkB;AAC/C,IAAA,IAAIA,aAAA,CAAO,wBAAA,CAAyB,SAAS,CAAA,EAAG;AAC9C,MAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,IACvE;AAEA,IAAA,IAAI,CAACA,aAAA,CAAO,uBAAA,CAAwB,SAAS,CAAA,EAAG;AAC9C,MAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,IACxC;AACA,IAAA,IAAI,EAAE,OAAO,QAAA,KAAa,QAAA,CAAA,EAAW;AACnC,MAAA,MAAM,IAAI,MAAM,iCAAiC,CAAA;AAAA,IACnD;AAEA,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAA,GAAS,IAAIC,kBAAgB,QAAQ,CAAA;AAAA,IACvC,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAEA,IAAA,IAAI,MAAA,CAAO,OAAM,EAAG;AAClB,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAEA,IAAA,IAAA,CAAK,UAAA,GAAa,SAAA;AAClB,IAAA,IAAA,CAAK,QAAA,GAAW,MAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAA,GAAoB;AAClB,IAAA,OAAO,IAAA,CAAK,UAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAA,GAAyB;AACvB,IAAA,OAAO,IAAA,CAAK,SAAS,QAAA,EAAS;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAA,GAAgC;AAC9B,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA;AAAA,EACtC;AACF;;;;"}

package/lib/cjs/base/address.js

@@ -0,0 +1,195 @@
+'use strict';
+
+var buffer = require('buffer');
+var strkey = require('./strkey.js');
+var curr_generated = require('./generated/curr_generated.js');
+
+class Address {
+  _type;
+  _key;
+  /**
+   * @param address - a {@link StrKey} of the address value
+   */
+  constructor(address) {
+    if (strkey.StrKey.isValidEd25519PublicKey(address)) {
+      this._type = "account";
+      this._key = strkey.StrKey.decodeEd25519PublicKey(address);
+    } else if (strkey.StrKey.isValidContract(address)) {
+      this._type = "contract";
+      this._key = strkey.StrKey.decodeContract(address);
+    } else if (strkey.StrKey.isValidMed25519PublicKey(address)) {
+      this._type = "muxedAccount";
+      this._key = strkey.StrKey.decodeMed25519PublicKey(address);
+    } else if (strkey.StrKey.isValidClaimableBalance(address)) {
+      this._type = "claimableBalance";
+      this._key = strkey.StrKey.decodeClaimableBalance(address);
+    } else if (strkey.StrKey.isValidLiquidityPool(address)) {
+      this._type = "liquidityPool";
+      this._key = strkey.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.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.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.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.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.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 curr_generated.default.ScAddressType.scAddressTypeAccount().value:
+        return Address.account(scAddress.accountId().ed25519());
+      case curr_generated.default.ScAddressType.scAddressTypeContract().value:
+        return Address.contract(scAddress.contractId());
+      case curr_generated.default.ScAddressType.scAddressTypeMuxedAccount().value: {
+        const raw = buffer.Buffer.concat([
+          scAddress.muxedAccount().ed25519(),
+          scAddress.muxedAccount().id().toXDR("raw")
+        ]);
+        return Address.muxedAccount(raw);
+      }
+      case curr_generated.default.ScAddressType.scAddressTypeClaimableBalance().value: {
+        const cbi = scAddress.claimableBalanceId();
+        return Address.claimableBalance(
+          buffer.Buffer.concat([buffer.Buffer.from([cbi.switch().value]), cbi.v0()])
+        );
+      }
+      case curr_generated.default.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.StrKey.encodeEd25519PublicKey(this._key);
+      case "contract":
+        return strkey.StrKey.encodeContract(this._key);
+      case "claimableBalance":
+        return strkey.StrKey.encodeClaimableBalance(this._key);
+      case "liquidityPool":
+        return strkey.StrKey.encodeLiquidityPool(this._key);
+      case "muxedAccount":
+        return strkey.StrKey.encodeMed25519PublicKey(this._key);
+      default:
+        throw new Error("Unsupported address type");
+    }
+  }
+  /**
+   * Convert this Address to an xdr.ScVal type.
+   */
+  toScVal() {
+    return curr_generated.default.ScVal.scvAddress(this.toScAddress());
+  }
+  /**
+   * Convert this Address to an xdr.ScAddress type.
+   */
+  toScAddress() {
+    switch (this._type) {
+      case "account":
+        return curr_generated.default.ScAddress.scAddressTypeAccount(
+          curr_generated.default.PublicKey.publicKeyTypeEd25519(this._key)
+        );
+      case "contract":
+        return curr_generated.default.ScAddress.scAddressTypeContract(
+          this._key
+        );
+      case "liquidityPool":
+        return curr_generated.default.ScAddress.scAddressTypeLiquidityPool(
+          this._key
+        );
+      case "claimableBalance":
+        return curr_generated.default.ScAddress.scAddressTypeClaimableBalance(
+          curr_generated.default.ClaimableBalanceId.claimableBalanceIdTypeV0(
+            this._key.subarray(1)
+          )
+        );
+      case "muxedAccount":
+        return curr_generated.default.ScAddress.scAddressTypeMuxedAccount(
+          new curr_generated.default.MuxedEd25519Account({
+            ed25519: this._key.subarray(0, 32),
+            id: curr_generated.default.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;
+  }
+}
+
+exports.Address = Address;
+//# sourceMappingURL=address.js.map

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