@digitalworld/digital-world-sdk 16.0.0

package/lib/esm/base/numbers/xdr_large_int.js

@@ -0,0 +1,271 @@
+import '../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
+import { Hyper } from '../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
+import '../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
+import { UnsignedHyper } from '../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
+import '../../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
+import 'buffer';
+import { Uint128 } from './uint128.js';
+import { Uint256 } from './uint256.js';
+import { Int128 } from './int128.js';
+import { Int256 } from './int256.js';
+import types from '../generated/curr_generated.js';
+
+class XdrLargeInt {
+  int;
+  type;
+  /**
+   * @param type - specifies a data type to use to represent the integer, one
+   *    of: 'i64', 'u64', 'i128', 'u128', 'i256', 'u256', 'timepoint', and 'duration'
+   *    (see {@link XdrLargeInt.isType})
+   * @param values - a list of integer-like values interpreted in big-endian order
+   */
+  constructor(type, values) {
+    if (!(values instanceof Array)) {
+      values = [values];
+    }
+    const normalizedValues = values.map((i) => {
+      if (typeof i === "bigint") {
+        return i;
+      }
+      if (typeof i === "object" && i !== null && "toBigInt" in i && typeof i.toBigInt === "function") {
+        return i.toBigInt();
+      }
+      return BigInt(i);
+    });
+    switch (type) {
+      case "i64":
+        this.int = new Hyper(normalizedValues);
+        break;
+      case "i128":
+        this.int = new Int128(...normalizedValues);
+        break;
+      case "i256":
+        this.int = new Int256(...normalizedValues);
+        break;
+      case "u64":
+      case "timepoint":
+      case "duration":
+        this.int = new UnsignedHyper(normalizedValues);
+        break;
+      case "u128":
+        this.int = new Uint128(...normalizedValues);
+        break;
+      case "u256":
+        this.int = new Uint256(...normalizedValues);
+        break;
+      default:
+        throw TypeError(`invalid type: ${type}`);
+    }
+    this.type = type;
+  }
+  /**
+   * Converts to a native JS number.
+   *
+   * @throws if the value can't fit into a Number
+   */
+  toNumber() {
+    const bi = this.int.toBigInt();
+    if (bi > Number.MAX_SAFE_INTEGER || bi < Number.MIN_SAFE_INTEGER) {
+      throw RangeError(
+        `value ${bi} not in range for Number [${Number.MAX_SAFE_INTEGER}, ${Number.MIN_SAFE_INTEGER}]`
+      );
+    }
+    return Number(bi);
+  }
+  /** Converts to a native BigInt. */
+  toBigInt() {
+    return this.int.toBigInt();
+  }
+  /**
+   * The integer encoded with `ScValType = I64`.
+   *
+   * @throws if the value cannot fit in 64 bits
+   */
+  toI64() {
+    this._sizeCheck(64);
+    const v = this.toBigInt();
+    if (BigInt.asIntN(64, v) !== v) {
+      throw RangeError(`value too large for i64: ${v}`);
+    }
+    return types.ScVal.scvI64(new types.Int64(v));
+  }
+  /** The integer encoded with `ScValType = U64` */
+  toU64() {
+    this._sizeCheck(64);
+    return types.ScVal.scvU64(
+      new types.Uint64(BigInt.asUintN(64, this.toBigInt()))
+      // reiterpret as unsigned
+    );
+  }
+  /** The integer encoded with `ScValType = Timepoint` */
+  toTimepoint() {
+    this._sizeCheck(64);
+    return types.ScVal.scvTimepoint(
+      new types.Uint64(BigInt.asUintN(64, this.toBigInt()))
+      // reiterpret as unsigned
+    );
+  }
+  /** The integer encoded with `ScValType = Duration` */
+  toDuration() {
+    this._sizeCheck(64);
+    return types.ScVal.scvDuration(
+      new types.Uint64(BigInt.asUintN(64, this.toBigInt()))
+      // reiterpret as unsigned
+    );
+  }
+  /**
+   * The integer encoded with `ScValType = I128`.
+   *
+   * @throws if the value cannot fit in 128 bits
+   */
+  toI128() {
+    this._sizeCheck(128);
+    const v = this.int.toBigInt();
+    if (BigInt.asIntN(128, v) !== v) {
+      throw RangeError(`value too large for i128: ${v}`);
+    }
+    const hi64 = BigInt.asIntN(64, v >> 64n);
+    const lo64 = BigInt.asUintN(64, v);
+    return types.ScVal.scvI128(
+      new types.Int128Parts({
+        hi: new types.Int64(hi64),
+        lo: new types.Uint64(lo64)
+      })
+    );
+  }
+  /**
+   * The integer encoded with `ScValType = U128`.
+   *
+   * @throws if the value cannot fit in 128 bits
+   */
+  toU128() {
+    this._sizeCheck(128);
+    const v = this.int.toBigInt();
+    return types.ScVal.scvU128(
+      new types.UInt128Parts({
+        hi: new types.Uint64(BigInt.asUintN(64, v >> 64n)),
+        lo: new types.Uint64(BigInt.asUintN(64, v))
+      })
+    );
+  }
+  /**
+   * The integer encoded with `ScValType = I256`
+   *
+   * @throws if the value cannot fit in a signed 256-bit integer
+   */
+  toI256() {
+    const v = this.int.toBigInt();
+    if (BigInt.asIntN(256, v) !== v) {
+      throw RangeError(`value too large for i256: ${v}`);
+    }
+    const hiHi64 = BigInt.asIntN(64, v >> 192n);
+    const hiLo64 = BigInt.asUintN(64, v >> 128n);
+    const loHi64 = BigInt.asUintN(64, v >> 64n);
+    const loLo64 = BigInt.asUintN(64, v);
+    return types.ScVal.scvI256(
+      new types.Int256Parts({
+        hiHi: new types.Int64(hiHi64),
+        hiLo: new types.Uint64(hiLo64),
+        loHi: new types.Uint64(loHi64),
+        loLo: new types.Uint64(loLo64)
+      })
+    );
+  }
+  /**
+   * The integer encoded with `ScValType = U256`
+   *
+   * Note: No size check needed - U256 is the largest unsigned type.
+   */
+  toU256() {
+    const v = this.int.toBigInt();
+    const hiHi64 = BigInt.asUintN(64, v >> 192n);
+    const hiLo64 = BigInt.asUintN(64, v >> 128n);
+    const loHi64 = BigInt.asUintN(64, v >> 64n);
+    const loLo64 = BigInt.asUintN(64, v);
+    return types.ScVal.scvU256(
+      new types.UInt256Parts({
+        hiHi: new types.Uint64(hiHi64),
+        hiLo: new types.Uint64(hiLo64),
+        loHi: new types.Uint64(loHi64),
+        loLo: new types.Uint64(loLo64)
+      })
+    );
+  }
+  /** The smallest interpretation of the stored value */
+  toScVal() {
+    switch (this.type) {
+      case "i64":
+        return this.toI64();
+      case "i128":
+        return this.toI128();
+      case "i256":
+        return this.toI256();
+      case "u64":
+        return this.toU64();
+      case "u128":
+        return this.toU128();
+      case "u256":
+        return this.toU256();
+      case "timepoint":
+        return this.toTimepoint();
+      case "duration":
+        return this.toDuration();
+      default:
+        throw TypeError(`invalid type: ${this.type}`);
+    }
+  }
+  /** Returns the primitive value of this integer. */
+  valueOf() {
+    return this.int.valueOf();
+  }
+  /** Returns the string representation of this integer. */
+  toString() {
+    return this.int.toString();
+  }
+  /** Returns a JSON-friendly representation with `value` and `type` fields. */
+  toJSON() {
+    return {
+      value: this.toBigInt().toString(),
+      type: this.type
+    };
+  }
+  _sizeCheck(bits) {
+    if (this.int.size > bits) {
+      throw RangeError(`value too large for ${bits} bits (${this.type})`);
+    }
+  }
+  /** Returns true if the given string is a valid XDR large integer type name. */
+  static isType(type) {
+    switch (type) {
+      case "i64":
+      case "i128":
+      case "i256":
+      case "u64":
+      case "u128":
+      case "u256":
+      case "timepoint":
+      case "duration":
+        return true;
+      default:
+        return false;
+    }
+  }
+  /**
+   * Convert the raw `ScValType` string (e.g. 'scvI128', generated by the XDR)
+   * to a type description for {@link XdrLargeInt} construction (e.g. 'i128')
+   *
+   * @param scvType - the `xdr.ScValType` as a string
+   * @returns the corresponding {@link ScIntType} if it's an integer type, or
+   *    `undefined` if it's not an integer type
+   */
+  static getType(scvType) {
+    const type = scvType.slice(3).toLowerCase();
+    if (this.isType(type)) {
+      return type;
+    }
+    return void 0;
+  }
+}
+
+export { XdrLargeInt };
+//# sourceMappingURL=xdr_large_int.js.map

package/lib/esm/base/numbers/xdr_large_int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xdr_large_int.js","sources":["../../../../src/base/numbers/xdr_large_int.ts"],"sourcesContent":["import { Hyper, LargeInt, UnsignedHyper } from \"@stellar/js-xdr\";\n\nimport { Uint128 } from \"./uint128.js\";\nimport { Uint256 } from \"./uint256.js\";\nimport { Int128 } from \"./int128.js\";\nimport { Int256 } from \"./int256.js\";\n\nimport xdr from \"../xdr.js\";\n\ntype BigIntLike = { toBigInt(): bigint };\ntype XdrLargeIntValues =\n  | Array<BigIntLike | bigint | number | string>\n  | BigIntLike\n  | bigint\n  | number\n  | string;\n\nexport type ScIntType =\n  | \"duration\"\n  | \"i64\"\n  | \"i128\"\n  | \"i256\"\n  | \"timepoint\"\n  | \"u64\"\n  | \"u128\"\n  | \"u256\";\n\n/**\n * A wrapper class to represent large XDR-encodable integers.\n *\n * This operates at a lower level than {@link ScInt} by forcing you to specify\n * the type / width / size in bits of the integer you're targeting, regardless\n * of the input value(s) you provide.\n */\nexport class XdrLargeInt {\n  int: LargeInt;\n  type: ScIntType;\n\n  /**\n   * @param type - specifies a data type to use to represent the integer, one\n   *    of: 'i64', 'u64', 'i128', 'u128', 'i256', 'u256', 'timepoint', and 'duration'\n   *    (see {@link XdrLargeInt.isType})\n   * @param values - a list of integer-like values interpreted in big-endian order\n   */\n  constructor(type: ScIntType, values: XdrLargeIntValues) {\n    if (!(values instanceof Array)) {\n      values = [values];\n    }\n\n    // normalize values to one type\n    const normalizedValues: bigint[] = values.map((i) => {\n      // micro-optimization to no-op on the likeliest input value:\n      if (typeof i === \"bigint\") {\n        return i;\n      }\n      if (\n        typeof i === \"object\" &&\n        i !== null &&\n        \"toBigInt\" in i &&\n        typeof i.toBigInt === \"function\"\n      ) {\n        return i.toBigInt();\n      }\n      return BigInt(i as number | string);\n    });\n\n    // Note: API difference in XDR constructors:\n    // - Hyper/UnsignedHyper accept an array parameter\n    // - Int128/Uint128/Int256/Uint256 accept rest parameters (require spread operator)\n    switch (type) {\n      case \"i64\":\n        this.int = new Hyper(normalizedValues);\n        break;\n      case \"i128\":\n        this.int = new Int128(...normalizedValues);\n        break;\n      case \"i256\":\n        this.int = new Int256(...normalizedValues);\n        break;\n      case \"u64\":\n      case \"timepoint\":\n      case \"duration\":\n        this.int = new UnsignedHyper(normalizedValues);\n        break;\n      case \"u128\":\n        this.int = new Uint128(...normalizedValues);\n        break;\n      case \"u256\":\n        this.int = new Uint256(...normalizedValues);\n        break;\n      default:\n        throw TypeError(`invalid type: ${type as string}`);\n    }\n\n    this.type = type;\n  }\n\n  /**\n   * Converts to a native JS number.\n   *\n   * @throws if the value can't fit into a Number\n   */\n  toNumber(): number {\n    const bi = this.int.toBigInt();\n    if (bi > Number.MAX_SAFE_INTEGER || bi < Number.MIN_SAFE_INTEGER) {\n      throw RangeError(\n        `value ${bi} not in range for Number ` +\n          `[${Number.MAX_SAFE_INTEGER}, ${Number.MIN_SAFE_INTEGER}]`,\n      );\n    }\n\n    return Number(bi);\n  }\n\n  /** Converts to a native BigInt. */\n  toBigInt(): bigint {\n    return this.int.toBigInt();\n  }\n\n  /**\n   * The integer encoded with `ScValType = I64`.\n   *\n   * @throws if the value cannot fit in 64 bits\n   */\n  toI64(): xdr.ScVal {\n    this._sizeCheck(64);\n    const v = this.toBigInt();\n    if (BigInt.asIntN(64, v) !== v) {\n      throw RangeError(`value too large for i64: ${v}`);\n    }\n\n    return xdr.ScVal.scvI64(new xdr.Int64(v));\n  }\n\n  /** The integer encoded with `ScValType = U64` */\n  toU64(): xdr.ScVal {\n    this._sizeCheck(64);\n    return xdr.ScVal.scvU64(\n      new xdr.Uint64(BigInt.asUintN(64, this.toBigInt())), // reiterpret as unsigned\n    );\n  }\n\n  /** The integer encoded with `ScValType = Timepoint` */\n  toTimepoint(): xdr.ScVal {\n    this._sizeCheck(64);\n    return xdr.ScVal.scvTimepoint(\n      new xdr.Uint64(BigInt.asUintN(64, this.toBigInt())), // reiterpret as unsigned\n    );\n  }\n\n  /** The integer encoded with `ScValType = Duration` */\n  toDuration(): xdr.ScVal {\n    this._sizeCheck(64);\n    return xdr.ScVal.scvDuration(\n      new xdr.Uint64(BigInt.asUintN(64, this.toBigInt())), // reiterpret as unsigned\n    );\n  }\n\n  /**\n   * The integer encoded with `ScValType = I128`.\n   *\n   * @throws if the value cannot fit in 128 bits\n   */\n  toI128(): xdr.ScVal {\n    this._sizeCheck(128);\n\n    const v = this.int.toBigInt();\n    if (BigInt.asIntN(128, v) !== v) {\n      throw RangeError(`value too large for i128: ${v}`);\n    }\n    const hi64 = BigInt.asIntN(64, v >> 64n); // encode top 64 w/ sign bit\n    const lo64 = BigInt.asUintN(64, v); // grab btm 64, encode sign\n\n    return xdr.ScVal.scvI128(\n      new xdr.Int128Parts({\n        hi: new xdr.Int64(hi64),\n        lo: new xdr.Uint64(lo64),\n      }),\n    );\n  }\n\n  /**\n   * The integer encoded with `ScValType = U128`.\n   *\n   * @throws if the value cannot fit in 128 bits\n   */\n  toU128(): xdr.ScVal {\n    this._sizeCheck(128);\n    const v = this.int.toBigInt();\n\n    return xdr.ScVal.scvU128(\n      new xdr.UInt128Parts({\n        hi: new xdr.Uint64(BigInt.asUintN(64, v >> 64n)),\n        lo: new xdr.Uint64(BigInt.asUintN(64, v)),\n      }),\n    );\n  }\n\n  /**\n   * The integer encoded with `ScValType = I256`\n   *\n   * @throws if the value cannot fit in a signed 256-bit integer\n   */\n  toI256(): xdr.ScVal {\n    const v = this.int.toBigInt();\n    if (BigInt.asIntN(256, v) !== v) {\n      throw RangeError(`value too large for i256: ${v}`);\n    }\n    const hiHi64 = BigInt.asIntN(64, v >> 192n); // keep sign bit\n    const hiLo64 = BigInt.asUintN(64, v >> 128n);\n    const loHi64 = BigInt.asUintN(64, v >> 64n);\n    const loLo64 = BigInt.asUintN(64, v);\n\n    return xdr.ScVal.scvI256(\n      new xdr.Int256Parts({\n        hiHi: new xdr.Int64(hiHi64),\n        hiLo: new xdr.Uint64(hiLo64),\n        loHi: new xdr.Uint64(loHi64),\n        loLo: new xdr.Uint64(loLo64),\n      }),\n    );\n  }\n\n  /**\n   * The integer encoded with `ScValType = U256`\n   *\n   * Note: No size check needed - U256 is the largest unsigned type.\n   */\n  toU256(): xdr.ScVal {\n    const v = this.int.toBigInt();\n    const hiHi64 = BigInt.asUintN(64, v >> 192n); // encode sign bit\n    const hiLo64 = BigInt.asUintN(64, v >> 128n);\n    const loHi64 = BigInt.asUintN(64, v >> 64n);\n    const loLo64 = BigInt.asUintN(64, v);\n\n    return xdr.ScVal.scvU256(\n      new xdr.UInt256Parts({\n        hiHi: new xdr.Uint64(hiHi64),\n        hiLo: new xdr.Uint64(hiLo64),\n        loHi: new xdr.Uint64(loHi64),\n        loLo: new xdr.Uint64(loLo64),\n      }),\n    );\n  }\n\n  /** The smallest interpretation of the stored value */\n  toScVal(): xdr.ScVal {\n    switch (this.type) {\n      case \"i64\":\n        return this.toI64();\n      case \"i128\":\n        return this.toI128();\n      case \"i256\":\n        return this.toI256();\n      case \"u64\":\n        return this.toU64();\n      case \"u128\":\n        return this.toU128();\n      case \"u256\":\n        return this.toU256();\n      case \"timepoint\":\n        return this.toTimepoint();\n      case \"duration\":\n        return this.toDuration();\n      default:\n        // This should be unreachable if the compiler enforces valid types\n        // This serves as a runtime check if the type is somehow invalid\n        // (e.g. from user input or a future extension)\n        throw TypeError(`invalid type: ${this.type as string}`);\n    }\n  }\n\n  /** Returns the primitive value of this integer. */\n  valueOf(): unknown {\n    return this.int.valueOf();\n  }\n\n  /** Returns the string representation of this integer. */\n  toString(): string {\n    return this.int.toString();\n  }\n\n  /** Returns a JSON-friendly representation with `value` and `type` fields. */\n  toJSON(): { value: string; type: string } {\n    return {\n      value: this.toBigInt().toString(),\n      type: this.type,\n    };\n  }\n\n  private _sizeCheck(bits: number): void {\n    if (this.int.size > bits) {\n      throw RangeError(`value too large for ${bits} bits (${this.type})`);\n    }\n  }\n\n  /** Returns true if the given string is a valid XDR large integer type name. */\n  static isType(type: string): type is ScIntType {\n    switch (type) {\n      case \"i64\":\n      case \"i128\":\n      case \"i256\":\n      case \"u64\":\n      case \"u128\":\n      case \"u256\":\n      case \"timepoint\":\n      case \"duration\":\n        return true;\n      default:\n        return false;\n    }\n  }\n\n  /**\n   * Convert the raw `ScValType` string (e.g. 'scvI128', generated by the XDR)\n   * to a type description for {@link XdrLargeInt} construction (e.g. 'i128')\n   *\n   * @param scvType - the `xdr.ScValType` as a string\n   * @returns the corresponding {@link ScIntType} if it's an integer type, or\n   *    `undefined` if it's not an integer type\n   */\n  static getType(scvType: string): ScIntType | undefined {\n    const type = scvType.slice(3).toLowerCase();\n    if (this.isType(type)) {\n      return type;\n    }\n\n    return undefined;\n  }\n}\n"],"names":["xdr"],"mappings":"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"}

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

@@ -0,0 +1,161 @@
+import xdr from "./xdr.js";
+import * as ops from "./operations/index.js";
+import type { OperationRecord, OperationType as _OperationType, BaseOperation as _BaseOperation, CreateAccountResult, PaymentResult, PathPaymentStrictReceiveResult, PathPaymentStrictSendResult, CreatePassiveSellOfferResult, ManageSellOfferResult, ManageBuyOfferResult, SetOptionsResult, ChangeTrustResult, AllowTrustResult, AccountMergeResult, InflationResult, ManageDataResult, BumpSequenceResult, CreateClaimableBalanceResult, ClaimClaimableBalanceResult, BeginSponsoringFutureReservesResult, EndSponsoringFutureReservesResult, RevokeAccountSponsorshipResult, RevokeTrustlineSponsorshipResult, RevokeOfferSponsorshipResult, RevokeDataSponsorshipResult, RevokeClaimableBalanceSponsorshipResult, RevokeLiquidityPoolSponsorshipResult, RevokeSignerSponsorshipResult, ClawbackResult, ClawbackClaimableBalanceResult, SetTrustLineFlagsResult, LiquidityPoolDepositResult, LiquidityPoolWithdrawResult, InvokeHostFunctionResult, ExtendFootprintTTLResult, RestoreFootprintResult, Signer } from "./operations/types.js";
+/**
+ * When set using `{@link Operation.setOptions}` option, requires the issuing
+ * account to give other accounts permission before they can hold the issuing
+ * account’s credit.
+ *
+ * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)
+ */
+export declare const AuthRequiredFlag: number;
+/**
+ * When set using `{@link Operation.setOptions}` option, allows the issuing
+ * account to revoke its credit held by other accounts.
+ *
+ * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)
+ */
+export declare const AuthRevocableFlag: number;
+/**
+ * When set using `{@link Operation.setOptions}` option, then none of the
+ * authorization flags can be set and the account can never be deleted.
+ *
+ * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)
+ */
+export declare const AuthImmutableFlag: number;
+/**
+ * When set using `{@link Operation.setOptions}` option, then any trustlines
+ * created by this account can have a ClawbackOp operation submitted for the
+ * corresponding asset.
+ *
+ * @see [Account flags](https://docs.digitalworld.global/docs/glossary/accounts/#flags)
+ */
+export declare const AuthClawbackEnabledFlag: number;
+/**
+ * `Operation` class represents
+ * [operations](https://docs.digitalworld.global/docs/glossary/operations/) in
+ * Digital World Network.
+ *
+ * Use one of static methods to create operations:
+ * * `{@link Operation.createAccount}`
+ * * `{@link Operation.payment}`
+ * * `{@link Operation.pathPaymentStrictReceive}`
+ * * `{@link Operation.pathPaymentStrictSend}`
+ * * `{@link Operation.manageSellOffer}`
+ * * `{@link Operation.manageBuyOffer}`
+ * * `{@link Operation.createPassiveSellOffer}`
+ * * `{@link Operation.setOptions}`
+ * * `{@link Operation.changeTrust}`
+ * * `{@link Operation.allowTrust}`
+ * * `{@link Operation.accountMerge}`
+ * * `{@link Operation.inflation}`
+ * * `{@link Operation.manageData}`
+ * * `{@link Operation.bumpSequence}`
+ * * `{@link Operation.createClaimableBalance}`
+ * * `{@link Operation.claimClaimableBalance}`
+ * * `{@link Operation.beginSponsoringFutureReserves}`
+ * * `{@link Operation.endSponsoringFutureReserves}`
+ * * `{@link Operation.revokeAccountSponsorship}`
+ * * `{@link Operation.revokeTrustlineSponsorship}`
+ * * `{@link Operation.revokeOfferSponsorship}`
+ * * `{@link Operation.revokeDataSponsorship}`
+ * * `{@link Operation.revokeClaimableBalanceSponsorship}`
+ * * `{@link Operation.revokeLiquidityPoolSponsorship}`
+ * * `{@link Operation.revokeSignerSponsorship}`
+ * * `{@link Operation.clawback}`
+ * * `{@link Operation.clawbackClaimableBalance}`
+ * * `{@link Operation.setTrustLineFlags}`
+ * * `{@link Operation.liquidityPoolDeposit}`
+ * * `{@link Operation.liquidityPoolWithdraw}`
+ * * `{@link Operation.invokeHostFunction}`, which has the following additional
+ *   "pseudo-operations" that make building host functions easier:
+ *   - `{@link Operation.createStellarAssetContract}`
+ *   - `{@link Operation.invokeContractFunction}`
+ *   - `{@link Operation.createCustomContract}`
+ *   - `{@link Operation.uploadContractWasm}`
+ * * `{@link Operation.extendFootprintTtlOp}`
+ * * `{@link Operation.restoreFootprint}`
+ *
+ */
+export declare class Operation {
+    /**
+     * Deconstructs the raw XDR operation object into the structured object that
+     * was used to create the operation (i.e. the `opts` parameter to most ops).
+     *
+     * @param operation - An XDR Operation.
+     */
+    static fromXDRObject<T extends OperationRecord = OperationRecord>(operation: xdr.Operation<T>): T;
+    static accountMerge: typeof ops.accountMerge;
+    static allowTrust: typeof ops.allowTrust;
+    static bumpSequence: typeof ops.bumpSequence;
+    static changeTrust: typeof ops.changeTrust;
+    static createAccount: typeof ops.createAccount;
+    static createClaimableBalance: typeof ops.createClaimableBalance;
+    static claimClaimableBalance: typeof ops.claimClaimableBalance;
+    static clawbackClaimableBalance: typeof ops.clawbackClaimableBalance;
+    static createPassiveSellOffer: typeof ops.createPassiveSellOffer;
+    static inflation: typeof ops.inflation;
+    static manageData: typeof ops.manageData;
+    static manageSellOffer: typeof ops.manageSellOffer;
+    static manageBuyOffer: typeof ops.manageBuyOffer;
+    static pathPaymentStrictReceive: typeof ops.pathPaymentStrictReceive;
+    static pathPaymentStrictSend: typeof ops.pathPaymentStrictSend;
+    static payment: typeof ops.payment;
+    static setOptions: typeof ops.setOptions;
+    static beginSponsoringFutureReserves: typeof ops.beginSponsoringFutureReserves;
+    static endSponsoringFutureReserves: typeof ops.endSponsoringFutureReserves;
+    static revokeAccountSponsorship: typeof ops.revokeAccountSponsorship;
+    static revokeTrustlineSponsorship: typeof ops.revokeTrustlineSponsorship;
+    static revokeOfferSponsorship: typeof ops.revokeOfferSponsorship;
+    static revokeDataSponsorship: typeof ops.revokeDataSponsorship;
+    static revokeClaimableBalanceSponsorship: typeof ops.revokeClaimableBalanceSponsorship;
+    static revokeLiquidityPoolSponsorship: typeof ops.revokeLiquidityPoolSponsorship;
+    static revokeSignerSponsorship: typeof ops.revokeSignerSponsorship;
+    static clawback: typeof ops.clawback;
+    static setTrustLineFlags: typeof ops.setTrustLineFlags;
+    static liquidityPoolDeposit: typeof ops.liquidityPoolDeposit;
+    static liquidityPoolWithdraw: typeof ops.liquidityPoolWithdraw;
+    static invokeHostFunction: typeof ops.invokeHostFunction;
+    static extendFootprintTtl: typeof ops.extendFootprintTtl;
+    static restoreFootprint: typeof ops.restoreFootprint;
+    static createStellarAssetContract: typeof ops.createStellarAssetContract;
+    static invokeContractFunction: typeof ops.invokeContractFunction;
+    static createCustomContract: typeof ops.createCustomContract;
+    static uploadContractWasm: typeof ops.uploadContractWasm;
+}
+export declare namespace Operation {
+    type BaseOperation<T extends _OperationType = _OperationType> = _BaseOperation<T>;
+    type CreateAccount = CreateAccountResult;
+    type Payment = PaymentResult;
+    type PathPaymentStrictReceive = PathPaymentStrictReceiveResult;
+    type PathPaymentStrictSend = PathPaymentStrictSendResult;
+    type CreatePassiveSellOffer = CreatePassiveSellOfferResult;
+    type ManageSellOffer = ManageSellOfferResult;
+    type ManageBuyOffer = ManageBuyOfferResult;
+    type SetOptions = SetOptionsResult<Signer>;
+    type ChangeTrust = ChangeTrustResult;
+    type AllowTrust = AllowTrustResult;
+    type AccountMerge = AccountMergeResult;
+    type Inflation = InflationResult;
+    type ManageData = ManageDataResult;
+    type BumpSequence = BumpSequenceResult;
+    type CreateClaimableBalance = CreateClaimableBalanceResult;
+    type ClaimClaimableBalance = ClaimClaimableBalanceResult;
+    type BeginSponsoringFutureReserves = BeginSponsoringFutureReservesResult;
+    type EndSponsoringFutureReserves = EndSponsoringFutureReservesResult;
+    type RevokeAccountSponsorship = RevokeAccountSponsorshipResult;
+    type RevokeTrustlineSponsorship = RevokeTrustlineSponsorshipResult;
+    type RevokeOfferSponsorship = RevokeOfferSponsorshipResult;
+    type RevokeDataSponsorship = RevokeDataSponsorshipResult;
+    type RevokeClaimableBalanceSponsorship = RevokeClaimableBalanceSponsorshipResult;
+    type RevokeLiquidityPoolSponsorship = RevokeLiquidityPoolSponsorshipResult;
+    type RevokeSignerSponsorship = RevokeSignerSponsorshipResult;
+    type Clawback = ClawbackResult;
+    type ClawbackClaimableBalance = ClawbackClaimableBalanceResult;
+    type SetTrustLineFlags = SetTrustLineFlagsResult;
+    type LiquidityPoolDeposit = LiquidityPoolDepositResult;
+    type LiquidityPoolWithdraw = LiquidityPoolWithdrawResult;
+    type InvokeHostFunction = InvokeHostFunctionResult;
+    type ExtendFootprintTTL = ExtendFootprintTTLResult;
+    type RestoreFootprint = RestoreFootprintResult;
+}