@digitalworld/digital-world-sdk 16.0.0

package/lib/esm/bindings/utils.d.ts

@@ -0,0 +1,53 @@
+import { xdr } from "../base/index.js";
+export declare function isNameReserved(name: string): boolean;
+/**
+ * Sanitize a name to avoid reserved keywords
+ * @param identifier - The identifier to sanitize
+ * @returns The sanitized identifier
+ */
+export declare function sanitizeIdentifier(identifier: string): string;
+/**
+ * Escape a string for safe interpolation inside a double-quoted JavaScript string literal.
+ */
+export declare function escapeStringLiteral(str: string): string;
+/**
+ * Generate TypeScript type from XDR type definition
+ */
+export declare function parseTypeFromTypeDef(typeDef: xdr.ScSpecTypeDef, isFunctionInput?: boolean): string;
+/**
+ * Imports needed for generating bindings
+ */
+export interface BindingImports {
+    /** Imports needed from type definitions */
+    typeFileImports: Set<string>;
+    /** Imports needed from the Stellar SDK in the contract namespace */
+    stellarContractImports: Set<string>;
+    /** Imports needed from Stellar SDK in the global namespace */
+    stellarImports: Set<string>;
+    /** Whether Buffer import is needed */
+    needsBufferImport: boolean;
+}
+/**
+ * Generate imports needed for a list of type definitions
+ */
+export declare function generateTypeImports(typeDefs: xdr.ScSpecTypeDef[]): BindingImports;
+/**
+ * Options for formatting imports
+ */
+export interface FormatImportsOptions {
+    /** Whether to include imports from types.ts */
+    includeTypeFileImports?: boolean;
+    /** Additional imports needed from stellar/stellar-sdk/contract */
+    additionalStellarContractImports?: string[];
+    /** Additional imports needed from stellar/stellar-sdk */
+    additionalStellarImports?: string[];
+}
+/**
+ * Format imports into import statement strings
+ */
+export declare function formatImports(imports: BindingImports, options?: FormatImportsOptions): string;
+/**
+ * Format a comment string as JSDoc with proper escaping
+ */
+export declare function formatJSDocComment(comment: string, indentLevel?: number): string;
+export declare function isTupleStruct(udtStruct: xdr.ScSpecUdtStructV0): boolean;

package/lib/esm/bindings/utils.js

@@ -0,0 +1,313 @@
+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 types from '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import '../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';
+
+function isNameReserved(name) {
+  const reservedNames = [
+    // Keywords
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "export",
+    "extends",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "new",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+    // Future reserved words
+    "enum",
+    // Strict mode reserved words
+    "implements",
+    "interface",
+    "let",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "static",
+    // Contextual keywords
+    "async",
+    "await",
+    "constructor",
+    // Literals
+    "null",
+    "true",
+    "false"
+  ];
+  return reservedNames.includes(name);
+}
+function sanitizeIdentifier(identifier) {
+  const sanitized = identifier.replace(/[^a-zA-Z0-9_$]/g, "_");
+  if (isNameReserved(sanitized)) {
+    return sanitized + "_";
+  }
+  if (/^\d/.test(sanitized)) {
+    return "_" + sanitized;
+  }
+  if (sanitized === "" || /^_+$/.test(sanitized)) {
+    return "_unnamed";
+  }
+  return sanitized;
+}
+function escapeStringLiteral(str) {
+  return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function parseTypeFromTypeDef(typeDef, isFunctionInput = false) {
+  switch (typeDef.switch()) {
+    case types.ScSpecType.scSpecTypeVal():
+      return "any";
+    case types.ScSpecType.scSpecTypeBool():
+      return "boolean";
+    case types.ScSpecType.scSpecTypeVoid():
+      return "null";
+    case types.ScSpecType.scSpecTypeError():
+      return "Error";
+    case types.ScSpecType.scSpecTypeU32():
+    case types.ScSpecType.scSpecTypeI32():
+      return "number";
+    case types.ScSpecType.scSpecTypeU64():
+    case types.ScSpecType.scSpecTypeI64():
+    case types.ScSpecType.scSpecTypeTimepoint():
+    case types.ScSpecType.scSpecTypeDuration():
+    case types.ScSpecType.scSpecTypeU128():
+    case types.ScSpecType.scSpecTypeI128():
+    case types.ScSpecType.scSpecTypeU256():
+    case types.ScSpecType.scSpecTypeI256():
+      return "bigint";
+    case types.ScSpecType.scSpecTypeBytes():
+    case types.ScSpecType.scSpecTypeBytesN():
+      return "Buffer";
+    case types.ScSpecType.scSpecTypeString():
+      return "string";
+    case types.ScSpecType.scSpecTypeSymbol():
+      return "string";
+    case types.ScSpecType.scSpecTypeAddress():
+    case types.ScSpecType.scSpecTypeMuxedAddress(): {
+      if (isFunctionInput) {
+        return "string | Address";
+      }
+      return "string";
+    }
+    case types.ScSpecType.scSpecTypeVec(): {
+      const vecType = parseTypeFromTypeDef(
+        typeDef.vec().elementType(),
+        isFunctionInput
+      );
+      return `Array<${vecType}>`;
+    }
+    case types.ScSpecType.scSpecTypeMap(): {
+      const keyType = parseTypeFromTypeDef(
+        typeDef.map().keyType(),
+        isFunctionInput
+      );
+      const valueType = parseTypeFromTypeDef(
+        typeDef.map().valueType(),
+        isFunctionInput
+      );
+      return `Map<${keyType}, ${valueType}>`;
+    }
+    case types.ScSpecType.scSpecTypeTuple(): {
+      const tupleTypes = typeDef.tuple().valueTypes().map(
+        (t) => parseTypeFromTypeDef(t, isFunctionInput)
+      );
+      return `[${tupleTypes.join(", ")}]`;
+    }
+    case types.ScSpecType.scSpecTypeOption(): {
+      while (typeDef.option().valueType().switch() === types.ScSpecType.scSpecTypeOption()) {
+        typeDef = typeDef.option().valueType();
+      }
+      const optionType = parseTypeFromTypeDef(
+        typeDef.option().valueType(),
+        isFunctionInput
+      );
+      return `${optionType} | null`;
+    }
+    case types.ScSpecType.scSpecTypeResult(): {
+      const okType = parseTypeFromTypeDef(
+        typeDef.result().okType(),
+        isFunctionInput
+      );
+      const errorType = parseTypeFromTypeDef(
+        typeDef.result().errorType(),
+        isFunctionInput
+      );
+      return `Result<${okType}, ${errorType}>`;
+    }
+    case types.ScSpecType.scSpecTypeUdt(): {
+      const udtName = sanitizeIdentifier(typeDef.udt().name().toString());
+      return udtName;
+    }
+    default:
+      return "unknown";
+  }
+}
+function extractNestedTypes(typeDef) {
+  switch (typeDef.switch()) {
+    case types.ScSpecType.scSpecTypeVec():
+      return [typeDef.vec().elementType()];
+    case types.ScSpecType.scSpecTypeMap():
+      return [typeDef.map().keyType(), typeDef.map().valueType()];
+    case types.ScSpecType.scSpecTypeTuple():
+      return typeDef.tuple().valueTypes();
+    case types.ScSpecType.scSpecTypeOption():
+      return [typeDef.option().valueType()];
+    case types.ScSpecType.scSpecTypeResult():
+      return [typeDef.result().okType(), typeDef.result().errorType()];
+    default:
+      return [];
+  }
+}
+function visitTypeDef(typeDef, accumulator) {
+  const typeSwitch = typeDef.switch();
+  switch (typeSwitch) {
+    case types.ScSpecType.scSpecTypeUdt():
+      accumulator.typeFileImports.add(
+        sanitizeIdentifier(typeDef.udt().name().toString())
+      );
+      return;
+    case types.ScSpecType.scSpecTypeAddress():
+    case types.ScSpecType.scSpecTypeMuxedAddress():
+      accumulator.stellarImports.add("Address");
+      return;
+    case types.ScSpecType.scSpecTypeBytes():
+    case types.ScSpecType.scSpecTypeBytesN():
+      accumulator.needsBufferImport = true;
+      return;
+    case types.ScSpecType.scSpecTypeVal():
+      accumulator.stellarImports.add("xdr");
+      return;
+    case types.ScSpecType.scSpecTypeResult():
+      accumulator.stellarContractImports.add("Result");
+      break;
+    // Primitive types that need no imports
+    case types.ScSpecType.scSpecTypeBool():
+    case types.ScSpecType.scSpecTypeVoid():
+    case types.ScSpecType.scSpecTypeError():
+    case types.ScSpecType.scSpecTypeU32():
+    case types.ScSpecType.scSpecTypeI32():
+    case types.ScSpecType.scSpecTypeU64():
+    case types.ScSpecType.scSpecTypeI64():
+    case types.ScSpecType.scSpecTypeTimepoint():
+    case types.ScSpecType.scSpecTypeDuration():
+    case types.ScSpecType.scSpecTypeU128():
+    case types.ScSpecType.scSpecTypeI128():
+    case types.ScSpecType.scSpecTypeU256():
+    case types.ScSpecType.scSpecTypeI256():
+    case types.ScSpecType.scSpecTypeString():
+    case types.ScSpecType.scSpecTypeSymbol():
+      return;
+  }
+  const nestedTypes = extractNestedTypes(typeDef);
+  nestedTypes.forEach((nested) => visitTypeDef(nested, accumulator));
+}
+function generateTypeImports(typeDefs) {
+  const imports = {
+    typeFileImports: /* @__PURE__ */ new Set(),
+    stellarContractImports: /* @__PURE__ */ new Set(),
+    stellarImports: /* @__PURE__ */ new Set(),
+    needsBufferImport: false
+  };
+  typeDefs.forEach((typeDef) => visitTypeDef(typeDef, imports));
+  return imports;
+}
+function formatImports(imports, options) {
+  const importLines = [];
+  const typeFileImports = imports.typeFileImports;
+  const stellarContractImports = [
+    ...imports.stellarContractImports,
+    ...options?.additionalStellarContractImports || []
+  ];
+  const stellarImports = [
+    ...imports.stellarImports,
+    ...options?.additionalStellarImports || []
+  ];
+  if (options?.includeTypeFileImports && typeFileImports.size > 0) {
+    importLines.push(
+      `import {${Array.from(typeFileImports).join(", ")}} from './types.js';`
+    );
+  }
+  if (stellarContractImports.length > 0) {
+    const uniqueContractImports = Array.from(new Set(stellarContractImports));
+    importLines.push(
+      `import {${uniqueContractImports.join(", ")}} from '@stellar/stellar-sdk/contract';`
+    );
+  }
+  if (stellarImports.length > 0) {
+    const uniqueStellarImports = Array.from(new Set(stellarImports));
+    importLines.push(
+      `import {${uniqueStellarImports.join(", ")}} from '@stellar/stellar-sdk';`
+    );
+  }
+  if (imports.needsBufferImport) {
+    importLines.push(`import { Buffer } from 'buffer';`);
+  }
+  return importLines.join("\n");
+}
+function escapeJSDocContent(text) {
+  return text.replace(/\*\//g, "* /").replace(
+    /@(?!(param|returns?|type|throws?|example|deprecated|see|link|since|author|version|description|summary)\b)/g,
+    "\\@"
+  );
+}
+function formatJSDocComment(comment, indentLevel = 0) {
+  if (comment.trim() === "") {
+    return "";
+  }
+  const indent = " ".repeat(indentLevel);
+  const escapedComment = escapeJSDocContent(comment);
+  const lines = escapedComment.split("\n").map((line) => `${indent} * ${line}`.trimEnd());
+  return `${indent}/**
+${lines.join("\n")}
+${indent} */
+`;
+}
+function isTupleStruct(udtStruct) {
+  const fields = udtStruct.fields();
+  return fields.every(
+    (field, index) => field.name().toString().trim() === index.toString()
+  );
+}
+
+export { escapeStringLiteral, formatImports, formatJSDocComment, generateTypeImports, isNameReserved, isTupleStruct, parseTypeFromTypeDef, sanitizeIdentifier };
+//# sourceMappingURL=utils.js.map

package/lib/esm/bindings/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/bindings/utils.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nexport function isNameReserved(name: string): boolean {\n  const reservedNames = [\n    // Keywords\n    \"break\",\n    \"case\",\n    \"catch\",\n    \"class\",\n    \"const\",\n    \"continue\",\n    \"debugger\",\n    \"default\",\n    \"delete\",\n    \"do\",\n    \"else\",\n    \"export\",\n    \"extends\",\n    \"finally\",\n    \"for\",\n    \"function\",\n    \"if\",\n    \"import\",\n    \"in\",\n    \"instanceof\",\n    \"new\",\n    \"return\",\n    \"super\",\n    \"switch\",\n    \"this\",\n    \"throw\",\n    \"try\",\n    \"typeof\",\n    \"var\",\n    \"void\",\n    \"while\",\n    \"with\",\n    \"yield\",\n    // Future reserved words\n    \"enum\",\n    // Strict mode reserved words\n    \"implements\",\n    \"interface\",\n    \"let\",\n    \"package\",\n    \"private\",\n    \"protected\",\n    \"public\",\n    \"static\",\n    // Contextual keywords\n    \"async\",\n    \"await\",\n    \"constructor\",\n    // Literals\n    \"null\",\n    \"true\",\n    \"false\",\n  ];\n  return reservedNames.includes(name);\n}\n/**\n * Sanitize a name to avoid reserved keywords\n * @param identifier - The identifier to sanitize\n * @returns The sanitized identifier\n */\nexport function sanitizeIdentifier(identifier: string): string {\n  // Strip any characters outside the ASCII identifier-safe set [a-zA-Z0-9_$]\n  const sanitized = identifier.replace(/[^a-zA-Z0-9_$]/g, \"_\");\n\n  if (isNameReserved(sanitized)) {\n    return sanitized + \"_\";\n  }\n\n  if (/^\\d/.test(sanitized)) {\n    return \"_\" + sanitized;\n  }\n\n  // If the identifier was entirely special characters, provide a fallback\n  if (sanitized === \"\" || /^_+$/.test(sanitized)) {\n    return \"_unnamed\";\n  }\n\n  return sanitized;\n}\n\n/**\n * Escape a string for safe interpolation inside a double-quoted JavaScript string literal.\n */\nexport function escapeStringLiteral(str: string): string {\n  return str\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\n/**\n * Generate TypeScript type from XDR type definition\n */\nexport function parseTypeFromTypeDef(\n  typeDef: xdr.ScSpecTypeDef,\n  isFunctionInput = false,\n): string {\n  switch (typeDef.switch()) {\n    case xdr.ScSpecType.scSpecTypeVal():\n      return \"any\";\n    case xdr.ScSpecType.scSpecTypeBool():\n      return \"boolean\";\n    case xdr.ScSpecType.scSpecTypeVoid():\n      return \"null\";\n    case xdr.ScSpecType.scSpecTypeError():\n      return \"Error\";\n    case xdr.ScSpecType.scSpecTypeU32():\n    case xdr.ScSpecType.scSpecTypeI32():\n      return \"number\";\n    case xdr.ScSpecType.scSpecTypeU64():\n    case xdr.ScSpecType.scSpecTypeI64():\n    case xdr.ScSpecType.scSpecTypeTimepoint():\n    case xdr.ScSpecType.scSpecTypeDuration():\n    case xdr.ScSpecType.scSpecTypeU128():\n    case xdr.ScSpecType.scSpecTypeI128():\n    case xdr.ScSpecType.scSpecTypeU256():\n    case xdr.ScSpecType.scSpecTypeI256():\n      return \"bigint\";\n    case xdr.ScSpecType.scSpecTypeBytes():\n    case xdr.ScSpecType.scSpecTypeBytesN():\n      return \"Buffer\";\n    case xdr.ScSpecType.scSpecTypeString():\n      return \"string\";\n    case xdr.ScSpecType.scSpecTypeSymbol():\n      return \"string\";\n    case xdr.ScSpecType.scSpecTypeAddress():\n    case xdr.ScSpecType.scSpecTypeMuxedAddress(): {\n      // function inputs can accept either string or Address\n      if (isFunctionInput) {\n        return \"string | Address\";\n      }\n      // Otherwise for backward compatibility use string\n      return \"string\";\n    }\n    case xdr.ScSpecType.scSpecTypeVec(): {\n      const vecType = parseTypeFromTypeDef(\n        typeDef.vec().elementType(),\n        isFunctionInput,\n      );\n      return `Array<${vecType}>`;\n    }\n    case xdr.ScSpecType.scSpecTypeMap(): {\n      const keyType = parseTypeFromTypeDef(\n        typeDef.map().keyType(),\n        isFunctionInput,\n      );\n      const valueType = parseTypeFromTypeDef(\n        typeDef.map().valueType(),\n        isFunctionInput,\n      );\n      return `Map<${keyType}, ${valueType}>`;\n    }\n    case xdr.ScSpecType.scSpecTypeTuple(): {\n      const tupleTypes = typeDef\n        .tuple()\n        .valueTypes()\n        .map((t: xdr.ScSpecTypeDef) =>\n          parseTypeFromTypeDef(t, isFunctionInput),\n        );\n      return `[${tupleTypes.join(\", \")}]`;\n    }\n    case xdr.ScSpecType.scSpecTypeOption(): {\n      // Handle nested options\n      while (\n        typeDef.option().valueType().switch() ===\n        xdr.ScSpecType.scSpecTypeOption()\n      ) {\n        typeDef = typeDef.option().valueType();\n      }\n      const optionType = parseTypeFromTypeDef(\n        typeDef.option().valueType(),\n        isFunctionInput,\n      );\n\n      return `${optionType} | null`;\n    }\n    case xdr.ScSpecType.scSpecTypeResult(): {\n      const okType = parseTypeFromTypeDef(\n        typeDef.result().okType(),\n        isFunctionInput,\n      );\n      const errorType = parseTypeFromTypeDef(\n        typeDef.result().errorType(),\n        isFunctionInput,\n      );\n      return `Result<${okType}, ${errorType}>`;\n    }\n    case xdr.ScSpecType.scSpecTypeUdt(): {\n      const udtName = sanitizeIdentifier(typeDef.udt().name().toString());\n      return udtName;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\n/**\n * Imports needed for generating bindings\n */\nexport interface BindingImports {\n  /** Imports needed from type definitions */\n  typeFileImports: Set<string>;\n  /** Imports needed from the Stellar SDK in the contract namespace */\n  stellarContractImports: Set<string>;\n  /** Imports needed from Stellar SDK in the global namespace */\n  stellarImports: Set<string>;\n  /** Whether Buffer import is needed */\n  needsBufferImport: boolean;\n}\n\n/**\n * Extract nested type definitions from container types\n */\nfunction extractNestedTypes(typeDef: xdr.ScSpecTypeDef): xdr.ScSpecTypeDef[] {\n  switch (typeDef.switch()) {\n    case xdr.ScSpecType.scSpecTypeVec():\n      return [typeDef.vec().elementType()];\n\n    case xdr.ScSpecType.scSpecTypeMap():\n      return [typeDef.map().keyType(), typeDef.map().valueType()];\n\n    case xdr.ScSpecType.scSpecTypeTuple():\n      return typeDef.tuple().valueTypes();\n\n    case xdr.ScSpecType.scSpecTypeOption():\n      return [typeDef.option().valueType()];\n\n    case xdr.ScSpecType.scSpecTypeResult():\n      return [typeDef.result().okType(), typeDef.result().errorType()];\n\n    default:\n      return [];\n  }\n}\n\n/**\n * Visitor to collect imports from a single type definition\n */\nfunction visitTypeDef(\n  typeDef: xdr.ScSpecTypeDef,\n  accumulator: BindingImports,\n): void {\n  const typeSwitch = typeDef.switch();\n\n  // Handle leaf types (no nested types)\n  switch (typeSwitch) {\n    case xdr.ScSpecType.scSpecTypeUdt():\n      accumulator.typeFileImports.add(\n        sanitizeIdentifier(typeDef.udt().name().toString()),\n      );\n      return;\n\n    case xdr.ScSpecType.scSpecTypeAddress():\n    case xdr.ScSpecType.scSpecTypeMuxedAddress():\n      accumulator.stellarImports.add(\"Address\");\n      return;\n\n    case xdr.ScSpecType.scSpecTypeBytes():\n    case xdr.ScSpecType.scSpecTypeBytesN():\n      accumulator.needsBufferImport = true;\n      return;\n\n    case xdr.ScSpecType.scSpecTypeVal():\n      accumulator.stellarImports.add(\"xdr\");\n      return;\n\n    case xdr.ScSpecType.scSpecTypeResult():\n      accumulator.stellarContractImports.add(\"Result\");\n      // Fall through to handle nested types\n      break;\n\n    // Primitive types that need no imports\n    case xdr.ScSpecType.scSpecTypeBool():\n    case xdr.ScSpecType.scSpecTypeVoid():\n    case xdr.ScSpecType.scSpecTypeError():\n    case xdr.ScSpecType.scSpecTypeU32():\n    case xdr.ScSpecType.scSpecTypeI32():\n    case xdr.ScSpecType.scSpecTypeU64():\n    case xdr.ScSpecType.scSpecTypeI64():\n    case xdr.ScSpecType.scSpecTypeTimepoint():\n    case xdr.ScSpecType.scSpecTypeDuration():\n    case xdr.ScSpecType.scSpecTypeU128():\n    case xdr.ScSpecType.scSpecTypeI128():\n    case xdr.ScSpecType.scSpecTypeU256():\n    case xdr.ScSpecType.scSpecTypeI256():\n    case xdr.ScSpecType.scSpecTypeString():\n    case xdr.ScSpecType.scSpecTypeSymbol():\n      return;\n  }\n\n  // Handle container types (have nested types)\n  const nestedTypes = extractNestedTypes(typeDef);\n  nestedTypes.forEach((nested) => visitTypeDef(nested, accumulator));\n}\n\n/**\n * Generate imports needed for a list of type definitions\n */\nexport function generateTypeImports(\n  typeDefs: xdr.ScSpecTypeDef[],\n): BindingImports {\n  const imports: BindingImports = {\n    typeFileImports: new Set<string>(),\n    stellarContractImports: new Set<string>(),\n    stellarImports: new Set<string>(),\n    needsBufferImport: false,\n  };\n\n  // Visit each type definition\n  typeDefs.forEach((typeDef) => visitTypeDef(typeDef, imports));\n\n  return imports;\n}\n\n/**\n * Options for formatting imports\n */\nexport interface FormatImportsOptions {\n  /** Whether to include imports from types.ts */\n  includeTypeFileImports?: boolean;\n  /** Additional imports needed from stellar/stellar-sdk/contract */\n  additionalStellarContractImports?: string[];\n  /** Additional imports needed from stellar/stellar-sdk */\n  additionalStellarImports?: string[];\n}\n\n/**\n * Format imports into import statement strings\n */\nexport function formatImports(\n  imports: BindingImports,\n  options?: FormatImportsOptions,\n): string {\n  const importLines: string[] = [];\n\n  const typeFileImports = imports.typeFileImports;\n  const stellarContractImports = [\n    ...imports.stellarContractImports,\n    ...(options?.additionalStellarContractImports || []),\n  ];\n  const stellarImports = [\n    ...imports.stellarImports,\n    ...(options?.additionalStellarImports || []),\n  ];\n  // Type file imports (only if enabled)\n  if (options?.includeTypeFileImports && typeFileImports.size > 0) {\n    importLines.push(\n      `import {${Array.from(typeFileImports).join(\", \")}} from './types.js';`,\n    );\n  }\n\n  // Stellar contract imports\n  if (stellarContractImports.length > 0) {\n    const uniqueContractImports = Array.from(new Set(stellarContractImports));\n    importLines.push(\n      `import {${uniqueContractImports.join(\", \")}} from '@stellar/stellar-sdk/contract';`,\n    );\n  }\n\n  // Stellar SDK imports\n  if (stellarImports.length > 0) {\n    const uniqueStellarImports = Array.from(new Set(stellarImports));\n    importLines.push(\n      `import {${uniqueStellarImports.join(\", \")}} from '@stellar/stellar-sdk';`,\n    );\n  }\n\n  // Buffer import\n  if (imports.needsBufferImport) {\n    importLines.push(`import { Buffer } from 'buffer';`);\n  }\n\n  return importLines.join(\"\\n\");\n}\n\n/**\n * Escape special characters in JSDoc comment content\n */\nfunction escapeJSDocContent(text: string): string {\n  return (\n    text\n      // Escape closing comment sequences that would break the JSDoc block\n      .replace(/\\*\\//g, \"* /\")\n      // Escape @ symbols at word boundaries to prevent accidental JSDoc tags\n      // We allow common JSDoc tags to pass through\n      .replace(\n        /@(?!(param|returns?|type|throws?|example|deprecated|see|link|since|author|version|description|summary)\\b)/g,\n        \"\\\\@\",\n      )\n  );\n}\n\n/**\n * Format a comment string as JSDoc with proper escaping\n */\nexport function formatJSDocComment(comment: string, indentLevel = 0): string {\n  if (comment.trim() === \"\") {\n    return \"\";\n  }\n  const indent = \" \".repeat(indentLevel);\n\n  // Escape special characters and split into lines\n  const escapedComment = escapeJSDocContent(comment);\n  const lines = escapedComment\n    .split(\"\\n\")\n    .map((line) => `${indent} * ${line}`.trimEnd());\n\n  return `${indent}/**\\n${lines.join(\"\\n\")}\\n${indent} */\\n`;\n}\n\nexport function isTupleStruct(udtStruct: xdr.ScSpecUdtStructV0): boolean {\n  const fields = udtStruct.fields();\n  // A tuple struct has unnamed fields\n  return fields.every(\n    (field, index) => field.name().toString().trim() === index.toString(),\n  );\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/esm/bindings/wasm_fetcher.d.ts

@@ -0,0 +1,25 @@
+import { Server } from "../rpc/index.js";
+/**
+ * Types of contract data that can be fetched
+ */
+export type ContractData = {
+    type: "wasm";
+    wasmBytes: Buffer;
+} | {
+    type: "stellar-asset-contract";
+};
+/**
+ * Errors that can occur during WASM fetching
+ */
+export declare class WasmFetchError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Fetch WASM from network using WASM hash
+ */
+export declare function fetchFromWasmHash(wasmHash: string, rpcServer: Server): Promise<ContractData>;
+/**
+ * Fetch WASM from network using contract ID
+ */
+export declare function fetchFromContractId(contractId: string, rpcServer: Server): Promise<ContractData>;

package/lib/esm/bindings/wasm_fetcher.js

@@ -0,0 +1,121 @@
+import { Buffer } from 'buffer';
+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 types from '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import '../base/keypair.js';
+import { StrKey } from '../base/strkey.js';
+import '../base/util/continued_fraction.js';
+import '../base/util/bignumber.js';
+import { Address } from '../base/address.js';
+import '../base/transaction_builder.js';
+import '../base/muxed_account.js';
+import { Contract } from '../base/contract.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';
+
+class WasmFetchError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "WasmFetchError";
+  }
+  cause;
+}
+async function getRemoteWasmFromHash(server, hashBuffer) {
+  try {
+    const contractCodeKey = types.LedgerKey.contractCode(
+      new types.LedgerKeyContractCode({
+        hash: types.Hash.fromXDR(hashBuffer, "raw")
+      })
+    );
+    const response = await server.getLedgerEntries(contractCodeKey);
+    if (!response.entries || response.entries.length === 0) {
+      throw new WasmFetchError("WASM not found for the given hash");
+    }
+    const entry = response.entries[0];
+    if (entry.key.switch() !== types.LedgerEntryType.contractCode()) {
+      throw new WasmFetchError("Invalid ledger entry type returned");
+    }
+    const contractCode = entry.val.contractCode();
+    return Buffer.from(contractCode.code());
+  } catch (error) {
+    if (error instanceof WasmFetchError) {
+      throw error;
+    }
+    throw new WasmFetchError("Failed to fetch WASM from hash", error);
+  }
+}
+function isStellarAssetContract(instance) {
+  return instance.executable().switch() === types.ContractExecutableType.contractExecutableStellarAsset();
+}
+async function fetchWasmFromContract(server, contractAddress) {
+  try {
+    const contract = new Contract(contractAddress.toString());
+    const response = await server.getLedgerEntries(contract.getFootprint());
+    if (!response.entries || response.entries.length === 0) {
+      throw new WasmFetchError("Contract instance not found");
+    }
+    const entry = response.entries[0];
+    if (entry.key.switch() !== types.LedgerEntryType.contractData()) {
+      throw new WasmFetchError("Invalid ledger entry type returned");
+    }
+    const contractData = entry.val.contractData();
+    const instance = contractData.val().instance();
+    if (isStellarAssetContract(instance)) {
+      return { type: "stellar-asset-contract" };
+    }
+    const wasmHash = instance.executable().wasmHash();
+    const wasmBytes = await getRemoteWasmFromHash(server, wasmHash);
+    return { type: "wasm", wasmBytes };
+  } catch (error) {
+    if (error instanceof WasmFetchError) {
+      throw error;
+    }
+    throw new WasmFetchError(
+      "Failed to fetch WASM from contract",
+      error
+    );
+  }
+}
+async function fetchFromWasmHash(wasmHash, rpcServer) {
+  try {
+    const hashBuffer = Buffer.from(wasmHash, "hex");
+    if (hashBuffer.length !== 32) {
+      throw new WasmFetchError(
+        `Invalid WASM hash length: expected 32 bytes, got ${hashBuffer.length}`
+      );
+    }
+    const wasmBytes = await getRemoteWasmFromHash(rpcServer, hashBuffer);
+    return { type: "wasm", wasmBytes };
+  } catch (error) {
+    throw new WasmFetchError(
+      `Failed to fetch WASM from hash ${wasmHash}`,
+      error
+    );
+  }
+}
+async function fetchFromContractId(contractId, rpcServer) {
+  try {
+    if (!StrKey.isValidContract(contractId)) {
+      throw new WasmFetchError(`Invalid contract ID: ${contractId}`);
+    }
+    const contractAddress = Address.fromString(contractId);
+    return await fetchWasmFromContract(rpcServer, contractAddress);
+  } catch (error) {
+    throw new WasmFetchError(
+      `Failed to fetch WASM from contract ${contractId}`,
+      error
+    );
+  }
+}
+
+export { WasmFetchError, fetchFromContractId, fetchFromWasmHash };
+//# sourceMappingURL=wasm_fetcher.js.map

package/lib/esm/bindings/wasm_fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm_fetcher.js","sources":["../../../src/bindings/wasm_fetcher.ts"],"sourcesContent":["import { Address, Contract, StrKey, xdr } from \"../base/index.js\";\nimport { Server } from \"../rpc/index.js\";\n\nimport { RpcServer } from \"../rpc/server.js\";\n\n/**\n * Types of contract data that can be fetched\n */\nexport type ContractData =\n  | { type: \"wasm\"; wasmBytes: Buffer }\n  | { type: \"stellar-asset-contract\" };\n\n/**\n * Errors that can occur during WASM fetching\n */\nexport class WasmFetchError extends Error {\n  constructor(\n    message: string,\n    public readonly cause?: Error,\n  ) {\n    super(message);\n    this.name = \"WasmFetchError\";\n  }\n}\n\n/**\n * Get WASM bytes from a WASM hash on the network\n */\nasync function getRemoteWasmFromHash(\n  server: RpcServer,\n  hashBuffer: Buffer,\n): Promise<Buffer> {\n  try {\n    // Create the ledger key for the contract code\n    const contractCodeKey = xdr.LedgerKey.contractCode(\n      new xdr.LedgerKeyContractCode({\n        hash: xdr.Hash.fromXDR(hashBuffer, \"raw\"),\n      }),\n    );\n\n    // Get the ledger entries\n    const response = await server.getLedgerEntries(contractCodeKey);\n\n    if (!response.entries || response.entries.length === 0) {\n      throw new WasmFetchError(\"WASM not found for the given hash\");\n    }\n\n    const entry = response.entries[0];\n    if (entry.key.switch() !== xdr.LedgerEntryType.contractCode()) {\n      throw new WasmFetchError(\"Invalid ledger entry type returned\");\n    }\n\n    const contractCode = entry.val.contractCode();\n    return Buffer.from(contractCode.code());\n  } catch (error) {\n    if (error instanceof WasmFetchError) {\n      throw error;\n    }\n    throw new WasmFetchError(\"Failed to fetch WASM from hash\", error as Error);\n  }\n}\n\n/**\n * Check if a contract is a Stellar Asset Contract\n */\nfunction isStellarAssetContract(instance: xdr.ScContractInstance): boolean {\n  // Check if it's a Stellar Asset Contract (has no WASM hash)\n  return (\n    instance.executable().switch() ===\n    xdr.ContractExecutableType.contractExecutableStellarAsset()\n  );\n}\n\n/**\n * Fetch WASM bytes from a deployed contract\n */\nasync function fetchWasmFromContract(\n  server: RpcServer,\n  contractAddress: Address,\n): Promise<ContractData> {\n  try {\n    const contract = new Contract(contractAddress.toString());\n\n    const response = await server.getLedgerEntries(contract.getFootprint());\n    if (!response.entries || response.entries.length === 0) {\n      throw new WasmFetchError(\"Contract instance not found\");\n    }\n\n    const entry = response.entries[0];\n    if (entry.key.switch() !== xdr.LedgerEntryType.contractData()) {\n      throw new WasmFetchError(\"Invalid ledger entry type returned\");\n    }\n\n    const contractData = entry.val.contractData();\n    const instance = contractData.val().instance();\n\n    if (isStellarAssetContract(instance)) {\n      return { type: \"stellar-asset-contract\" };\n    }\n\n    const wasmHash = instance.executable().wasmHash();\n    const wasmBytes = await getRemoteWasmFromHash(server, wasmHash);\n    return { type: \"wasm\", wasmBytes };\n  } catch (error) {\n    if (error instanceof WasmFetchError) {\n      throw error;\n    }\n    throw new WasmFetchError(\n      \"Failed to fetch WASM from contract\",\n      error as Error,\n    );\n  }\n}\n\n/**\n * Fetch WASM from network using WASM hash\n */\nexport async function fetchFromWasmHash(\n  wasmHash: string,\n  rpcServer: Server,\n): Promise<ContractData> {\n  try {\n    // Validate and decode the hash\n    const hashBuffer = Buffer.from(wasmHash, \"hex\");\n    if (hashBuffer.length !== 32) {\n      throw new WasmFetchError(\n        `Invalid WASM hash length: expected 32 bytes, got ${hashBuffer.length}`,\n      );\n    }\n\n    // Get WASM from hash\n    const wasmBytes = await getRemoteWasmFromHash(rpcServer, hashBuffer);\n\n    return { type: \"wasm\", wasmBytes };\n  } catch (error) {\n    throw new WasmFetchError(\n      `Failed to fetch WASM from hash ${wasmHash}`,\n      error as Error,\n    );\n  }\n}\n\n/**\n * Fetch WASM from network using contract ID\n */\nexport async function fetchFromContractId(\n  contractId: string,\n  rpcServer: Server,\n): Promise<ContractData> {\n  try {\n    if (!StrKey.isValidContract(contractId)) {\n      throw new WasmFetchError(`Invalid contract ID: ${contractId}`);\n    }\n    // Parse contract address\n    const contractAddress = Address.fromString(contractId);\n\n    // Try to get WASM from contract\n    return await fetchWasmFromContract(rpcServer, contractAddress);\n  } catch (error) {\n    throw new WasmFetchError(\n      `Failed to fetch WASM from contract ${contractId}`,\n      error as Error,\n    );\n  }\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/esm/browser-axios.d.ts

@@ -0,0 +1,4 @@
+import { httpClient } from "./http-client/axios.js";
+export * from "./index.js";
+export * as DigitalWorldBase from "./base/index.js";
+export { httpClient };

package/lib/esm/browser.d.ts

@@ -0,0 +1,4 @@
+import { httpClient } from "./http-client/index.js";
+export * from "./index.js";
+export * as DigitalWorldBase from "./base/index.js";
+export { httpClient };

package/lib/esm/cli/index.d.ts

@@ -0,0 +1,2 @@
+declare function runCli(): void;
+export { runCli };