@digitalworld/digital-world-sdk 16.0.0

package/lib/esm/base/operations/set_options.d.ts

@@ -0,0 +1,34 @@
+import xdr from "../xdr.js";
+import { SetOptionsOpts, SetOptionsResult, SignerOpts } from "./types.js";
+/**
+ * Returns an XDR SetOptionsOp. A "set options" operations set or clear account flags,
+ * set the account's inflation destination, and/or add new signers to the account.
+ * The flags used in `opts.clearFlags` and `opts.setFlags` can be the following:
+ *   - `{@link AuthRequiredFlag}`
+ *   - `{@link AuthRevocableFlag}`
+ *   - `{@link AuthImmutableFlag}`
+ *   - `{@link AuthClawbackEnabledFlag}`
+ *
+ * It's possible to set/clear multiple flags at once using logical or.
+ *
+ *
+ * @param opts - Options object
+ *   - `inflationDest`: Set this account ID as the account's inflation destination.
+ *   - `clearFlags`: Bitmap integer for which account flags to clear.
+ *   - `setFlags`: Bitmap integer for which account flags to set.
+ *   - `masterWeight`: The master key weight.
+ *   - `lowThreshold`: The sum weight for the low threshold.
+ *   - `medThreshold`: The sum weight for the medium threshold.
+ *   - `highThreshold`: The sum weight for the high threshold.
+ *   - `signer`: Add or remove a signer from the account. The signer is
+ *                                 deleted if the weight is 0. Only one of `ed25519PublicKey`, `sha256Hash`, `preAuthTx` should be defined.
+ *   - `signer.ed25519PublicKey`: The ed25519 public key of the signer.
+ *   - `signer.sha256Hash`: sha256 hash (Buffer or hex string) of preimage that will unlock funds. Preimage should be used as signature of future transaction.
+ *   - `signer.preAuthTx`: Hash (Buffer or hex string) of transaction that will unlock funds.
+ *   - `signer.ed25519SignedPayload`: Signed payload signer (ed25519 public key + raw payload) for atomic transaction signature disclosure.
+ *   - `signer.weight`: The weight of the new signer (0 to delete or 1-255)
+ *   - `homeDomain`: sets the home domain used for reverse federation lookup.
+ *   - `source`: The source account (defaults to transaction source).
+ * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)
+ */
+export declare function setOptions<T extends SignerOpts = never>(opts: SetOptionsOpts<T>): xdr.Operation<SetOptionsResult<T>>;

package/lib/esm/base/operations/set_options.js

@@ -0,0 +1,136 @@
+import { Buffer } from 'buffer';
+import types from '../generated/curr_generated.js';
+import { Keypair } from '../keypair.js';
+import { StrKey } from '../strkey.js';
+import { checkUnsignedIntValue, setSourceAccount } from '../util/operations.js';
+
+function weightCheckFunction(value, name) {
+  if (value >= 0 && value <= 255) {
+    return true;
+  }
+  throw new Error(`${name} value must be between 0 and 255`);
+}
+function setOptions(opts) {
+  let inflationDest = null;
+  if (opts.inflationDest) {
+    if (!StrKey.isValidEd25519PublicKey(opts.inflationDest)) {
+      throw new Error("inflationDest is invalid");
+    }
+    inflationDest = Keypair.fromPublicKey(opts.inflationDest).xdrAccountId();
+  }
+  const clearFlags = checkUnsignedIntValue("clearFlags", opts.clearFlags) ?? null;
+  const setFlags = checkUnsignedIntValue("setFlags", opts.setFlags) ?? null;
+  const masterWeight = checkUnsignedIntValue(
+    "masterWeight",
+    opts.masterWeight,
+    weightCheckFunction
+  ) ?? null;
+  const lowThreshold = checkUnsignedIntValue(
+    "lowThreshold",
+    opts.lowThreshold,
+    weightCheckFunction
+  ) ?? null;
+  const medThreshold = checkUnsignedIntValue(
+    "medThreshold",
+    opts.medThreshold,
+    weightCheckFunction
+  ) ?? null;
+  const highThreshold = checkUnsignedIntValue(
+    "highThreshold",
+    opts.highThreshold,
+    weightCheckFunction
+  ) ?? null;
+  if (opts.homeDomain !== void 0 && typeof opts.homeDomain !== "string") {
+    throw new TypeError("homeDomain argument must be of type String");
+  }
+  const homeDomain = opts.homeDomain;
+  let signer = null;
+  if (opts.signer) {
+    const weight = checkUnsignedIntValue(
+      "signer.weight",
+      opts.signer.weight,
+      weightCheckFunction
+    );
+    let key;
+    let setValues = 0;
+    if (opts.signer.ed25519PublicKey) {
+      if (!StrKey.isValidEd25519PublicKey(opts.signer.ed25519PublicKey)) {
+        throw new Error("signer.ed25519PublicKey is invalid.");
+      }
+      const rawKey = StrKey.decodeEd25519PublicKey(
+        opts.signer.ed25519PublicKey
+      );
+      key = types.SignerKey.signerKeyTypeEd25519(rawKey);
+      setValues += 1;
+    }
+    if (opts.signer.preAuthTx) {
+      let preAuthTx;
+      if (typeof opts.signer.preAuthTx === "string") {
+        preAuthTx = Buffer.from(opts.signer.preAuthTx, "hex");
+      } else {
+        preAuthTx = opts.signer.preAuthTx;
+      }
+      if (!(Buffer.isBuffer(preAuthTx) && preAuthTx.length === 32)) {
+        throw new Error("signer.preAuthTx must be 32 bytes Buffer.");
+      }
+      key = types.SignerKey.signerKeyTypePreAuthTx(preAuthTx);
+      setValues += 1;
+    }
+    if (opts.signer.sha256Hash) {
+      let sha256Hash;
+      if (typeof opts.signer.sha256Hash === "string") {
+        sha256Hash = Buffer.from(opts.signer.sha256Hash, "hex");
+      } else {
+        sha256Hash = opts.signer.sha256Hash;
+      }
+      if (!(Buffer.isBuffer(sha256Hash) && sha256Hash.length === 32)) {
+        throw new Error("signer.sha256Hash must be 32 bytes Buffer.");
+      }
+      key = types.SignerKey.signerKeyTypeHashX(sha256Hash);
+      setValues += 1;
+    }
+    if (opts.signer.ed25519SignedPayload) {
+      if (!StrKey.isValidSignedPayload(opts.signer.ed25519SignedPayload)) {
+        throw new Error("signer.ed25519SignedPayload is invalid.");
+      }
+      const rawKey = StrKey.decodeSignedPayload(
+        opts.signer.ed25519SignedPayload
+      );
+      const signedPayloadXdr = types.SignerKeyEd25519SignedPayload.fromXDR(rawKey);
+      key = types.SignerKey.signerKeyTypeEd25519SignedPayload(signedPayloadXdr);
+      setValues += 1;
+    }
+    if (setValues !== 1) {
+      throw new Error(
+        "Signer object must contain exactly one of signer.ed25519PublicKey, signer.sha256Hash, signer.preAuthTx, or signer.ed25519SignedPayload."
+      );
+    }
+    if (weight === void 0) {
+      throw new Error("signer weight is required.");
+    }
+    if (key === void 0) {
+      throw new Error("signer key is required.");
+    }
+    signer = new types.Signer({ key, weight });
+  }
+  const setOptionsOp = new types.SetOptionsOp({
+    inflationDest,
+    clearFlags,
+    setFlags,
+    masterWeight,
+    lowThreshold,
+    medThreshold,
+    highThreshold,
+    homeDomain,
+    signer
+  });
+  const opAttributes = {
+    sourceAccount: null,
+    body: types.OperationBody.setOptions(setOptionsOp)
+  };
+  setSourceAccount(opAttributes, opts);
+  return new types.Operation(opAttributes);
+}
+
+export { setOptions };
+//# sourceMappingURL=set_options.js.map

package/lib/esm/base/operations/set_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_options.js","sources":["../../../../src/base/operations/set_options.ts"],"sourcesContent":["import xdr from \"../xdr.js\";\nimport { Keypair } from \"../keypair.js\";\nimport { StrKey } from \"../strkey.js\";\nimport {\n  SetOptionsOpts,\n  SetOptionsResult,\n  OperationAttributes,\n  SignerOpts,\n} from \"./types.js\";\nimport { checkUnsignedIntValue, setSourceAccount } from \"../util/operations.js\";\n\nfunction weightCheckFunction(value: number, name: string): boolean {\n  if (value >= 0 && value <= 255) {\n    return true;\n  }\n  throw new Error(`${name} value must be between 0 and 255`);\n}\n\n/**\n * Returns an XDR SetOptionsOp. A \"set options\" operations set or clear account flags,\n * set the account's inflation destination, and/or add new signers to the account.\n * The flags used in `opts.clearFlags` and `opts.setFlags` can be the following:\n *   - `{@link AuthRequiredFlag}`\n *   - `{@link AuthRevocableFlag}`\n *   - `{@link AuthImmutableFlag}`\n *   - `{@link AuthClawbackEnabledFlag}`\n *\n * It's possible to set/clear multiple flags at once using logical or.\n *\n *\n * @param opts - Options object\n *   - `inflationDest`: Set this account ID as the account's inflation destination.\n *   - `clearFlags`: Bitmap integer for which account flags to clear.\n *   - `setFlags`: Bitmap integer for which account flags to set.\n *   - `masterWeight`: The master key weight.\n *   - `lowThreshold`: The sum weight for the low threshold.\n *   - `medThreshold`: The sum weight for the medium threshold.\n *   - `highThreshold`: The sum weight for the high threshold.\n *   - `signer`: Add or remove a signer from the account. The signer is\n *                                 deleted if the weight is 0. Only one of `ed25519PublicKey`, `sha256Hash`, `preAuthTx` should be defined.\n *   - `signer.ed25519PublicKey`: The ed25519 public key of the signer.\n *   - `signer.sha256Hash`: sha256 hash (Buffer or hex string) of preimage that will unlock funds. Preimage should be used as signature of future transaction.\n *   - `signer.preAuthTx`: Hash (Buffer or hex string) of transaction that will unlock funds.\n *   - `signer.ed25519SignedPayload`: Signed payload signer (ed25519 public key + raw payload) for atomic transaction signature disclosure.\n *   - `signer.weight`: The weight of the new signer (0 to delete or 1-255)\n *   - `homeDomain`: sets the home domain used for reverse federation lookup.\n *   - `source`: The source account (defaults to transaction source).\n * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)\n */\nexport function setOptions<T extends SignerOpts = never>(\n  opts: SetOptionsOpts<T>,\n): xdr.Operation<SetOptionsResult<T>> {\n  let inflationDest: xdr.AccountId | null = null;\n\n  if (opts.inflationDest) {\n    if (!StrKey.isValidEd25519PublicKey(opts.inflationDest)) {\n      throw new Error(\"inflationDest is invalid\");\n    }\n    inflationDest = Keypair.fromPublicKey(opts.inflationDest).xdrAccountId();\n  }\n\n  const clearFlags =\n    checkUnsignedIntValue(\"clearFlags\", opts.clearFlags) ?? null;\n  const setFlags = checkUnsignedIntValue(\"setFlags\", opts.setFlags) ?? null;\n  const masterWeight =\n    checkUnsignedIntValue(\n      \"masterWeight\",\n      opts.masterWeight,\n      weightCheckFunction,\n    ) ?? null;\n  const lowThreshold =\n    checkUnsignedIntValue(\n      \"lowThreshold\",\n      opts.lowThreshold,\n      weightCheckFunction,\n    ) ?? null;\n  const medThreshold =\n    checkUnsignedIntValue(\n      \"medThreshold\",\n      opts.medThreshold,\n      weightCheckFunction,\n    ) ?? null;\n  const highThreshold =\n    checkUnsignedIntValue(\n      \"highThreshold\",\n      opts.highThreshold,\n      weightCheckFunction,\n    ) ?? null;\n\n  if (opts.homeDomain !== undefined && typeof opts.homeDomain !== \"string\") {\n    throw new TypeError(\"homeDomain argument must be of type String\");\n  }\n  const homeDomain = opts.homeDomain;\n\n  let signer: xdr.Signer | null = null;\n\n  if (opts.signer) {\n    const weight = checkUnsignedIntValue(\n      \"signer.weight\",\n      opts.signer.weight,\n      weightCheckFunction,\n    );\n    let key: xdr.SignerKey | undefined;\n\n    let setValues = 0;\n\n    if (opts.signer.ed25519PublicKey) {\n      if (!StrKey.isValidEd25519PublicKey(opts.signer.ed25519PublicKey)) {\n        throw new Error(\"signer.ed25519PublicKey is invalid.\");\n      }\n      const rawKey = StrKey.decodeEd25519PublicKey(\n        opts.signer.ed25519PublicKey,\n      );\n\n      key = xdr.SignerKey.signerKeyTypeEd25519(rawKey);\n      setValues += 1;\n    }\n\n    if (opts.signer.preAuthTx) {\n      let preAuthTx: Buffer;\n      if (typeof opts.signer.preAuthTx === \"string\") {\n        preAuthTx = Buffer.from(opts.signer.preAuthTx, \"hex\");\n      } else {\n        preAuthTx = opts.signer.preAuthTx;\n      }\n\n      if (!(Buffer.isBuffer(preAuthTx) && preAuthTx.length === 32)) {\n        throw new Error(\"signer.preAuthTx must be 32 bytes Buffer.\");\n      }\n\n      key = xdr.SignerKey.signerKeyTypePreAuthTx(preAuthTx);\n      setValues += 1;\n    }\n\n    if (opts.signer.sha256Hash) {\n      let sha256Hash: Buffer;\n      if (typeof opts.signer.sha256Hash === \"string\") {\n        sha256Hash = Buffer.from(opts.signer.sha256Hash, \"hex\");\n      } else {\n        sha256Hash = opts.signer.sha256Hash;\n      }\n\n      if (!(Buffer.isBuffer(sha256Hash) && sha256Hash.length === 32)) {\n        throw new Error(\"signer.sha256Hash must be 32 bytes Buffer.\");\n      }\n\n      key = xdr.SignerKey.signerKeyTypeHashX(sha256Hash);\n      setValues += 1;\n    }\n\n    if (opts.signer.ed25519SignedPayload) {\n      if (!StrKey.isValidSignedPayload(opts.signer.ed25519SignedPayload)) {\n        throw new Error(\"signer.ed25519SignedPayload is invalid.\");\n      }\n      const rawKey = StrKey.decodeSignedPayload(\n        opts.signer.ed25519SignedPayload,\n      );\n      const signedPayloadXdr =\n        xdr.SignerKeyEd25519SignedPayload.fromXDR(rawKey);\n\n      key = xdr.SignerKey.signerKeyTypeEd25519SignedPayload(signedPayloadXdr);\n      setValues += 1;\n    }\n\n    if (setValues !== 1) {\n      throw new Error(\n        \"Signer object must contain exactly one of signer.ed25519PublicKey, signer.sha256Hash, signer.preAuthTx, or signer.ed25519SignedPayload.\",\n      );\n    }\n    if (weight === undefined) {\n      throw new Error(\"signer weight is required.\");\n    }\n    if (key === undefined) {\n      throw new Error(\"signer key is required.\");\n    }\n    signer = new xdr.Signer({ key: key, weight: weight });\n  }\n\n  const setOptionsOp = new xdr.SetOptionsOp({\n    inflationDest,\n    clearFlags,\n    setFlags,\n    masterWeight,\n    lowThreshold,\n    medThreshold,\n    highThreshold,\n    homeDomain: homeDomain as string | null,\n    signer,\n  });\n\n  const opAttributes: OperationAttributes = {\n    sourceAccount: null,\n    body: xdr.OperationBody.setOptions(setOptionsOp),\n  };\n  setSourceAccount(opAttributes, opts);\n\n  return new xdr.Operation(opAttributes);\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/esm/base/operations/set_trustline_flags.d.ts

@@ -0,0 +1,31 @@
+import xdr from "../xdr.js";
+import { SetTrustLineFlagsOpts, SetTrustLineFlagsResult } from "./types.js";
+/**
+ * Creates a trustline flag configuring operation.
+ *
+ * For the flags, set them to true to enable them and false to disable them. Any
+ * unmodified operations will be marked `undefined` in the result.
+ *
+ * Note that you can only **clear** the clawbackEnabled flag set; it must be set
+ * account-wide via operations.SetOptions (setting
+ * xdr.AccountFlags.clawbackEnabled).
+ *
+ *
+ * @param opts - Options object
+ *   - `trustor`: the account whose trustline this is
+ *   - `asset`: the asset on the trustline
+ *   - `flags`: the set of flags to modify
+ *   - `flags.authorized`: authorize account to perform
+ *     transactions with its credit
+ *   - `flags.authorizedToMaintainLiabilities`: authorize
+ *     account to maintain and reduce liabilities for its credit
+ *   - `flags.clawbackEnabled`: stop claimable balances on
+ *     this trustlines from having clawbacks enabled (this flag can only be set
+ *     to false!)
+ *   - `source`: The source account for the operation.
+ *                                 Defaults to the transaction's source account.
+ *
+ * @see https://github.com/stellar/stellar-protocol/blob/master/core/cap-0035.md#set-trustline-flags-operation
+ * @see https://docs.digitalworld.global/docs/start/list-of-operations/#set-options
+ */
+export declare function setTrustLineFlags(opts: SetTrustLineFlagsOpts): xdr.Operation<SetTrustLineFlagsResult>;

package/lib/esm/base/operations/set_trustline_flags.js

@@ -0,0 +1,54 @@
+import types from '../generated/curr_generated.js';
+import { Keypair } from '../keypair.js';
+import { setSourceAccount } from '../util/operations.js';
+
+function setTrustLineFlags(opts) {
+  if (typeof opts.flags !== "object" || Object.keys(opts.flags).length === 0) {
+    throw new Error("opts.flags must be a map of boolean flags to modify");
+  }
+  const mapping = {
+    authorized: types.TrustLineFlags.authorizedFlag(),
+    authorizedToMaintainLiabilities: types.TrustLineFlags.authorizedToMaintainLiabilitiesFlag(),
+    clawbackEnabled: types.TrustLineFlags.trustlineClawbackEnabledFlag()
+  };
+  let clearFlag = 0;
+  let setFlag = 0;
+  Object.keys(opts.flags).forEach((flagName) => {
+    if (!Object.prototype.hasOwnProperty.call(mapping, flagName)) {
+      throw new Error(`unsupported flag name specified: ${flagName}`);
+    }
+    const flagValue = opts.flags[flagName];
+    const bit = mapping[flagName];
+    if (!bit) {
+      throw new Error(`Invalid flag name: ${flagName}`);
+    }
+    if (typeof flagValue !== "boolean" && typeof flagValue !== "undefined") {
+      throw new TypeError(
+        `opts.flags.${flagName} must be a boolean (got ${typeof flagValue})`
+      );
+    }
+    if (flagValue === true) {
+      setFlag |= bit.value;
+    } else if (flagValue === false) {
+      clearFlag |= bit.value;
+    }
+  });
+  const trustor = Keypair.fromPublicKey(opts.trustor).xdrAccountId();
+  const asset = opts.asset.toXDRObject();
+  const opAttributes = {
+    sourceAccount: null,
+    body: types.OperationBody.setTrustLineFlags(
+      new types.SetTrustLineFlagsOp({
+        trustor,
+        asset,
+        clearFlags: clearFlag,
+        setFlags: setFlag
+      })
+    )
+  };
+  setSourceAccount(opAttributes, opts);
+  return new types.Operation(opAttributes);
+}
+
+export { setTrustLineFlags };
+//# sourceMappingURL=set_trustline_flags.js.map

package/lib/esm/base/operations/set_trustline_flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_trustline_flags.js","sources":["../../../../src/base/operations/set_trustline_flags.ts"],"sourcesContent":["import xdr from \"../xdr.js\";\nimport { Keypair } from \"../keypair.js\";\nimport {\n  SetTrustLineFlagsOpts,\n  SetTrustLineFlagsResult,\n  TrustLineFlagMap,\n  OperationAttributes,\n} from \"./types.js\";\nimport { setSourceAccount } from \"../util/operations.js\";\n\n/**\n * Creates a trustline flag configuring operation.\n *\n * For the flags, set them to true to enable them and false to disable them. Any\n * unmodified operations will be marked `undefined` in the result.\n *\n * Note that you can only **clear** the clawbackEnabled flag set; it must be set\n * account-wide via operations.SetOptions (setting\n * xdr.AccountFlags.clawbackEnabled).\n *\n *\n * @param opts - Options object\n *   - `trustor`: the account whose trustline this is\n *   - `asset`: the asset on the trustline\n *   - `flags`: the set of flags to modify\n *   - `flags.authorized`: authorize account to perform\n *     transactions with its credit\n *   - `flags.authorizedToMaintainLiabilities`: authorize\n *     account to maintain and reduce liabilities for its credit\n *   - `flags.clawbackEnabled`: stop claimable balances on\n *     this trustlines from having clawbacks enabled (this flag can only be set\n *     to false!)\n *   - `source`: The source account for the operation.\n *                                 Defaults to the transaction's source account.\n *\n * @see https://github.com/stellar/stellar-protocol/blob/master/core/cap-0035.md#set-trustline-flags-operation\n * @see https://docs.digitalworld.global/docs/start/list-of-operations/#set-options\n */\nexport function setTrustLineFlags(\n  opts: SetTrustLineFlagsOpts,\n): xdr.Operation<SetTrustLineFlagsResult> {\n  if (typeof opts.flags !== \"object\" || Object.keys(opts.flags).length === 0) {\n    throw new Error(\"opts.flags must be a map of boolean flags to modify\");\n  }\n\n  const mapping: Record<string, { value: number }> = {\n    authorized: xdr.TrustLineFlags.authorizedFlag(),\n    authorizedToMaintainLiabilities:\n      xdr.TrustLineFlags.authorizedToMaintainLiabilitiesFlag(),\n    clawbackEnabled: xdr.TrustLineFlags.trustlineClawbackEnabledFlag(),\n  };\n\n  /* eslint no-bitwise: \"off\" */\n  let clearFlag = 0;\n  let setFlag = 0;\n\n  Object.keys(opts.flags).forEach((flagName) => {\n    if (!Object.prototype.hasOwnProperty.call(mapping, flagName)) {\n      throw new Error(`unsupported flag name specified: ${flagName}`);\n    }\n\n    const flagValue = opts.flags[flagName as keyof TrustLineFlagMap];\n    const bit = mapping[flagName];\n    if (!bit) {\n      throw new Error(`Invalid flag name: ${flagName}`);\n    }\n\n    if (typeof flagValue !== \"boolean\" && typeof flagValue !== \"undefined\") {\n      throw new TypeError(\n        `opts.flags.${flagName} must be a boolean (got ${typeof flagValue})`,\n      );\n    }\n\n    if (flagValue === true) {\n      setFlag |= bit.value;\n    } else if (flagValue === false) {\n      clearFlag |= bit.value;\n    }\n  });\n\n  const trustor = Keypair.fromPublicKey(opts.trustor).xdrAccountId();\n  const asset = opts.asset.toXDRObject();\n\n  const opAttributes: OperationAttributes = {\n    sourceAccount: null,\n    body: xdr.OperationBody.setTrustLineFlags(\n      new xdr.SetTrustLineFlagsOp({\n        trustor,\n        asset,\n        clearFlags: clearFlag,\n        setFlags: setFlag,\n      }),\n    ),\n  };\n  setSourceAccount(opAttributes, opts);\n\n  return new xdr.Operation(opAttributes);\n}\n"],"names":["xdr"],"mappings":";;;;AAsCO,SAAS,kBACd,IAAA,EACwC;AACxC,EAAA,IAAI,OAAO,IAAA,CAAK,KAAA,KAAU,QAAA,IAAY,MAAA,CAAO,KAAK,IAAA,CAAK,KAAK,CAAA,CAAE,MAAA,KAAW,CAAA,EAAG;AAC1E,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AAEA,EAAA,MAAM,OAAA,GAA6C;AAAA,IACjD,UAAA,EAAYA,KAAA,CAAI,cAAA,CAAe,cAAA,EAAe;AAAA,IAC9C,+BAAA,EACEA,KAAA,CAAI,cAAA,CAAe,mCAAA,EAAoC;AAAA,IACzD,eAAA,EAAiBA,KAAA,CAAI,cAAA,CAAe,4BAAA;AAA6B,GACnE;AAGA,EAAA,IAAI,SAAA,GAAY,CAAA;AAChB,EAAA,IAAI,OAAA,GAAU,CAAA;AAEd,EAAA,MAAA,CAAO,KAAK,IAAA,CAAK,KAAK,CAAA,CAAE,OAAA,CAAQ,CAAC,QAAA,KAAa;AAC5C,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,eAAe,IAAA,CAAK,OAAA,EAAS,QAAQ,CAAA,EAAG;AAC5D,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iCAAA,EAAoC,QAAQ,CAAA,CAAE,CAAA;AAAA,IAChE;AAEA,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,KAAA,CAAM,QAAkC,CAAA;AAC/D,IAAA,MAAM,GAAA,GAAM,QAAQ,QAAQ,CAAA;AAC5B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,QAAQ,CAAA,CAAE,CAAA;AAAA,IAClD;AAEA,IAAA,IAAI,OAAO,SAAA,KAAc,SAAA,IAAa,OAAO,cAAc,WAAA,EAAa;AACtE,MAAA,MAAM,IAAI,SAAA;AAAA,QACR,CAAA,WAAA,EAAc,QAAQ,CAAA,wBAAA,EAA2B,OAAO,SAAS,CAAA,CAAA;AAAA,OACnE;AAAA,IACF;AAEA,IAAA,IAAI,cAAc,IAAA,EAAM;AACtB,MAAA,OAAA,IAAW,GAAA,CAAI,KAAA;AAAA,IACjB,CAAA,MAAA,IAAW,cAAc,KAAA,EAAO;AAC9B,MAAA,SAAA,IAAa,GAAA,CAAI,KAAA;AAAA,IACnB;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAM,UAAU,OAAA,CAAQ,aAAA,CAAc,IAAA,CAAK,OAAO,EAAE,YAAA,EAAa;AACjE,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,WAAA,EAAY;AAErC,EAAA,MAAM,YAAA,GAAoC;AAAA,IACxC,aAAA,EAAe,IAAA;AAAA,IACf,IAAA,EAAMA,MAAI,aAAA,CAAc,iBAAA;AAAA,MACtB,IAAIA,MAAI,mBAAA,CAAoB;AAAA,QAC1B,OAAA;AAAA,QACA,KAAA;AAAA,QACA,UAAA,EAAY,SAAA;AAAA,QACZ,QAAA,EAAU;AAAA,OACX;AAAA;AACH,GACF;AACA,EAAA,gBAAA,CAAiB,cAAc,IAAI,CAAA;AAEnC,EAAA,OAAO,IAAIA,KAAA,CAAI,SAAA,CAAU,YAAY,CAAA;AACvC;;;;"}