@digitalworld/digital-world-sdk 16.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sources":["../../../../src/base/util/operations.ts"],"sourcesContent":["import { OperationAttributes } from \"../operations/types.js\";\nimport xdr from \"../xdr.js\";\nimport { best_r } from \"./continued_fraction.js\";\nimport { decodeAddressToMuxedAccount } from \"./decode_encode_muxed_account.js\";\nimport type { BigNumber } from \"./bignumber.js\";\nimport CustomBigNumber from \"./bignumber.js\";\nexport const ONE = 10000000;\nconst MAX_INT64 = \"9223372036854775807\";\n\n/** Sets the source account on the operation attributes from the opts.*/\nexport function setSourceAccount(\n  opAttributes: OperationAttributes,\n  opts: { source?: string },\n) {\n  if (opts.source) {\n    try {\n      opAttributes.sourceAccount = decodeAddressToMuxedAccount(opts.source);\n    } catch {\n      throw new Error(\"Source address is invalid\");\n    }\n  }\n}\n\n/**\n * Returns value converted to uint32 value or undefined.\n * If `value` is not `Number`, `String` or `Undefined` then throws an error.\n * Used in {@link Operation.setOptions}.\n *\n * @param name - name of the property (used in error message only)\n * @param value - value to check\n * @param isValidFunction - function to check other constraints (the argument will be a `Number`)\n */\nexport function checkUnsignedIntValue(\n  name: string,\n  value: number | string | undefined,\n  isValidFunction: ((value: number, name: string) => boolean) | null = null,\n): number | undefined {\n  if (typeof value === \"undefined\") {\n    return undefined;\n  }\n\n  const numValue =\n    typeof value === \"string\"\n      ? value.trim() === \"\"\n        ? NaN\n        : Number(value)\n      : value;\n\n  if (\n    typeof numValue !== \"number\" ||\n    !Number.isFinite(numValue) ||\n    numValue % 1 !== 0\n  ) {\n    throw new Error(`${name} value is invalid`);\n  }\n\n  if (numValue < 0) {\n    throw new Error(`${name} value must be unsigned`);\n  }\n\n  if (!isValidFunction || isValidFunction(numValue, name)) {\n    return numValue;\n  }\n\n  throw new Error(`${name} value is invalid`);\n}\n/**\n * Converts a string amount to an XDR Int64 value (scaled by 10^7).\n *\n * @param value - the amount as a string\n */\nexport function toXDRAmount(value: string): xdr.Int64 {\n  const amount = new CustomBigNumber(value).times(ONE);\n  return xdr.Int64.fromString(amount.toString());\n}\n\n/**\n * Converts an XDR Int64 amount to a decimal string (divided by 10^7).\n *\n * @param value - the XDR amount\n */\nexport function fromXDRAmount(value: xdr.Int64): string {\n  return new CustomBigNumber(value.toString()).div(ONE).toFixed(7);\n}\n\n/**\n * Converts an XDR Price (n/d) to a decimal string.\n *\n * @param price - the XDR price object\n */\nexport function fromXDRPrice(price: xdr.Price): string {\n  const n = new CustomBigNumber(price.n());\n  return n.div(new CustomBigNumber(price.d())).toString();\n}\n\n/**\n * Converts a number, string, or `{n, d}` object to an XDR Price.\n *\n * @param price - the price as a number, string, or `{n, d}` fraction\n */\nexport function toXDRPrice(\n  price: BigNumber | number | string | { n: number; d: number },\n): xdr.Price {\n  let xdrObject: xdr.Price;\n\n  if (typeof price === \"object\" && \"n\" in price && \"d\" in price) {\n    xdrObject = new xdr.Price(price);\n  } else {\n    const priceBN = new CustomBigNumber(price);\n    if (!priceBN.gt(0) || !priceBN.isFinite()) {\n      throw new Error(\"price must be positive\");\n    }\n    const approx = best_r(price);\n    xdrObject = new xdr.Price({\n      n: parseInt(String(approx[0]), 10),\n      d: parseInt(String(approx[1]), 10),\n    });\n  }\n\n  if (xdrObject.n() < 0 || xdrObject.d() <= 0) {\n    throw new Error(\"price must be positive\");\n  }\n\n  return xdrObject;\n}\n\n/**\n * Validates that a given amount is possible for a Digital World asset.\n *\n * Specifically, this means that the amount is well, a valid number, but also\n * that it is within the int64 range and has no more than 7 decimal levels of\n * precision.\n *\n * Note that while smart contracts allow larger amounts, this is oriented\n * towards validating the standard Digital World operations.\n *\n * @param value - the amount to validate\n * @param allowZero - optionally, whether or not zero is valid (default: no)\n */\nexport function isValidAmount(value: unknown, allowZero = false): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n\n  let amount;\n\n  try {\n    amount = new CustomBigNumber(value);\n  } catch {\n    return false;\n  }\n\n  if (\n    // == 0\n    (!allowZero && amount.isZero()) ||\n    // < 0\n    amount.isNegative() ||\n    // > Max value\n    amount.times(ONE).gt(new CustomBigNumber(MAX_INT64).toString()) ||\n    // Decimal places (max 7)\n    (amount.decimalPlaces() ?? 0) > 7 ||\n    // NaN or Infinity\n    amount.isNaN() ||\n    !amount.isFinite()\n  ) {\n    return false;\n  }\n\n  return true;\n}\n\n/** Returns a standard error message for invalid amount arguments.*/\nexport function constructAmountRequirementsError(arg: string): string {\n  return `${arg} argument must be of type String, represent a positive number and have at most 7 digits after the decimal`;\n}\n"],"names":["CustomBigNumber","xdr"],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+/**
+ * Removes trailing occurrences of `char` from the end of `input`.
+ *
+ * @param input - the value to trim
+ * @param char - the character to remove from the end
+ */
+export declare const trimEnd: (input: number | string, char: string) => number | string;

package/lib/esm/base/util/util.js

@@ -0,0 +1,11 @@
+const trimEnd = (input, char) => {
+  const isNumber = typeof input === "number";
+  let str = String(input);
+  while (str.endsWith(char)) {
+    str = str.slice(0, -1);
+  }
+  return isNumber ? Number(str) : str;
+};
+
+export { trimEnd };
+//# sourceMappingURL=util.js.map

package/lib/esm/base/util/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sources":["../../../../src/base/util/util.ts"],"sourcesContent":["/**\n * Removes trailing occurrences of `char` from the end of `input`.\n *\n * @param input - the value to trim\n * @param char - the character to remove from the end\n */\nexport const trimEnd = (\n  input: number | string,\n  char: string,\n): number | string => {\n  const isNumber = typeof input === \"number\";\n  let str = String(input);\n\n  while (str.endsWith(char)) {\n    str = str.slice(0, -1);\n  }\n\n  return isNumber ? Number(str) : str;\n};\n"],"names":[],"mappings":"AAMO,MAAM,OAAA,GAAU,CACrB,KAAA,EACA,IAAA,KACoB;AACpB,EAAA,MAAM,QAAA,GAAW,OAAO,KAAA,KAAU,QAAA;AAClC,EAAA,IAAI,GAAA,GAAM,OAAO,KAAK,CAAA;AAEtB,EAAA,OAAO,GAAA,CAAI,QAAA,CAAS,IAAI,CAAA,EAAG;AACzB,IAAA,GAAA,GAAM,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AAAA,EACvB;AAEA,EAAA,OAAO,QAAA,GAAW,MAAA,CAAO,GAAG,CAAA,GAAI,GAAA;AAClC;;;;"}

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

@@ -0,0 +1,2 @@
+import xdr from "./generated/curr_generated.js";
+export default xdr;

package/lib/esm/base/xdr.js

@@ -0,0 +1,6 @@
+import types from './generated/curr_generated.js';
+
+
+
+export { types as default };
+//# sourceMappingURL=xdr.js.map

package/lib/esm/base/xdr.js.map

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

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

@@ -0,0 +1,30 @@
+import { Spec } from "../contract/index.js";
+/**
+ * Generates TypeScript client class for contract methods
+ */
+export declare class ClientGenerator {
+    private spec;
+    constructor(spec: Spec);
+    /**
+     * Generate client class
+     */
+    generate(): string;
+    private generateImports;
+    /**
+     * Generate interface method signature
+     */
+    private generateInterfaceMethod;
+    private generateFromJSONMethod;
+    /**
+     * Generate deploy method
+     */
+    private generateDeployMethod;
+    /**
+     * Format method parameters
+     */
+    private formatMethodParameters;
+    /**
+     * Format constructor parameters
+     */
+    private formatConstructorParameters;
+}

package/lib/esm/bindings/client.js

@@ -0,0 +1,138 @@
+import { generateTypeImports, formatImports, sanitizeIdentifier, parseTypeFromTypeDef, formatJSDocComment } from './utils.js';
+
+class ClientGenerator {
+  spec;
+  constructor(spec) {
+    this.spec = spec;
+  }
+  /**
+   * Generate client class
+   */
+  generate() {
+    let deployMethod = "";
+    try {
+      const constructorFunc = this.spec.getFunc("__constructor");
+      deployMethod = this.generateDeployMethod(constructorFunc);
+    } catch {
+      deployMethod = this.generateDeployMethod(void 0);
+    }
+    const interfaceMethods = this.spec.funcs().filter((func) => func.name().toString() !== "__constructor").map((func) => this.generateInterfaceMethod(func)).join("\n");
+    const imports = this.generateImports();
+    const specEntries = this.spec.entries.map(
+      (entry) => `"${entry.toXDR("base64")}"`
+    );
+    const fromJSON = this.spec.funcs().filter((func) => func.name().toString() !== "__constructor").map((func) => this.generateFromJSONMethod(func)).join(",");
+    return `${imports}
+
+export interface Client {
+${interfaceMethods}
+}
+
+export class Client extends ContractClient {
+  constructor(public readonly options: ContractClientOptions) {
+    super(
+      new Spec([${specEntries.join(", ")}]),
+      options
+    );
+  }
+
+ ${deployMethod}
+  public readonly fromJSON = {
+  ${fromJSON}
+  };
+}`;
+  }
+  generateImports() {
+    const imports = generateTypeImports(
+      this.spec.funcs().flatMap((func) => {
+        const inputs = func.inputs();
+        const outputs = func.outputs();
+        const defs = inputs.map((input) => input.type()).concat(outputs);
+        return defs;
+      })
+    );
+    return formatImports(imports, {
+      includeTypeFileImports: true,
+      // Client imports types
+      additionalStellarContractImports: [
+        "Spec",
+        "AssembledTransaction",
+        "Client as ContractClient",
+        "ClientOptions as ContractClientOptions",
+        "MethodOptions"
+      ]
+    });
+  }
+  /**
+   * Generate interface method signature
+   */
+  generateInterfaceMethod(func) {
+    const name = sanitizeIdentifier(func.name().toString());
+    const inputs = func.inputs().map((input) => ({
+      name: sanitizeIdentifier(input.name().toString()),
+      type: parseTypeFromTypeDef(input.type(), true)
+    }));
+    const outputType = func.outputs().length > 0 ? parseTypeFromTypeDef(func.outputs()[0]) : "void";
+    const docs = formatJSDocComment(func.doc().toString(), 2);
+    const params = this.formatMethodParameters(inputs);
+    return `${docs}  ${name}(${params}): Promise<AssembledTransaction<${outputType}>>;`;
+  }
+  generateFromJSONMethod(func) {
+    const name = sanitizeIdentifier(func.name().toString());
+    const outputType = func.outputs().length > 0 ? parseTypeFromTypeDef(func.outputs()[0]) : "void";
+    return `  ${name} : this.txFromJSON<${outputType}>`;
+  }
+  /**
+   * Generate deploy method
+   */
+  generateDeployMethod(constructorFunc) {
+    if (!constructorFunc) {
+      const params2 = this.formatConstructorParameters([]);
+      return `  static deploy<T = Client>(${params2}): Promise<AssembledTransaction<T>> {
+    return ContractClient.deploy(null, options);
+  }`;
+    }
+    const inputs = constructorFunc.inputs().map((input) => ({
+      name: sanitizeIdentifier(input.name().toString()),
+      type: parseTypeFromTypeDef(input.type(), true)
+    }));
+    const params = this.formatConstructorParameters(inputs);
+    const inputsDestructure = inputs.length > 0 ? `{ ${inputs.map((i) => i.name).join(", ")} }, ` : "";
+    return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {
+    return ContractClient.deploy(${inputsDestructure}options);
+  }`;
+  }
+  /**
+   * Format method parameters
+   */
+  formatMethodParameters(inputs) {
+    const params = [];
+    if (inputs.length > 0) {
+      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join("; ")} }`;
+      params.push(
+        `{ ${inputs.map((i) => i.name).join(", ")} }: ${inputsParam}`
+      );
+    }
+    params.push("options?: MethodOptions");
+    return params.join(", ");
+  }
+  /**
+   * Format constructor parameters
+   */
+  formatConstructorParameters(inputs) {
+    const params = [];
+    if (inputs.length > 0) {
+      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join("; ")} }`;
+      params.push(
+        `{ ${inputs.map((i) => i.name).join(", ")} }: ${inputsParam}`
+      );
+    }
+    params.push(
+      `options: MethodOptions & Omit<ContractClientOptions, 'contractId'> & { wasmHash: Buffer | string; salt?: Buffer | Uint8Array; format?: "hex" | "base64"; address?: string; }`
+    );
+    return params.join(", ");
+  }
+}
+
+export { ClientGenerator };
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../../../src/bindings/client.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport { Spec } from \"../contract/index.js\";\nimport {\n  parseTypeFromTypeDef,\n  generateTypeImports,\n  sanitizeIdentifier,\n  formatJSDocComment,\n  formatImports,\n} from \"./utils.js\";\n\n/**\n * Generates TypeScript client class for contract methods\n */\nexport class ClientGenerator {\n  private spec: Spec;\n\n  constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Generate client class\n   */\n  generate(): string {\n    // Generate constructor method if it exists\n    let deployMethod = \"\";\n    try {\n      const constructorFunc = this.spec.getFunc(\"__constructor\");\n      deployMethod = this.generateDeployMethod(constructorFunc);\n    } catch {\n      // For specs without a constructor, generate a deploy method without params\n      deployMethod = this.generateDeployMethod(undefined);\n    }\n    // Generate interface methods\n    const interfaceMethods = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateInterfaceMethod(func))\n      .join(\"\\n\");\n\n    const imports = this.generateImports();\n\n    const specEntries = this.spec.entries.map(\n      (entry) => `\"${entry.toXDR(\"base64\")}\"`,\n    );\n\n    const fromJSON = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateFromJSONMethod(func))\n      .join(\",\");\n\n    return `${imports}\n\nexport interface Client {\n${interfaceMethods}\n}\n\nexport class Client extends ContractClient {\n  constructor(public readonly options: ContractClientOptions) {\n    super(\n      new Spec([${specEntries.join(\", \")}]),\n      options\n    );\n  }\n\n ${deployMethod}\n  public readonly fromJSON = {\n  ${fromJSON}\n  };\n}`;\n  }\n\n  private generateImports(): string {\n    const imports = generateTypeImports(\n      this.spec.funcs().flatMap((func) => {\n        const inputs = func.inputs();\n        const outputs = func.outputs();\n        const defs = inputs.map((input) => input.type()).concat(outputs);\n        return defs;\n      }),\n    );\n\n    return formatImports(imports, {\n      includeTypeFileImports: true, // Client imports types\n      additionalStellarContractImports: [\n        \"Spec\",\n        \"AssembledTransaction\",\n        \"Client as ContractClient\",\n        \"ClientOptions as ContractClientOptions\",\n        \"MethodOptions\",\n      ],\n    });\n  }\n\n  /**\n   * Generate interface method signature\n   */\n  private generateInterfaceMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const inputs = func.inputs().map((input: any) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n    const docs = formatJSDocComment(func.doc().toString(), 2);\n    const params = this.formatMethodParameters(inputs);\n\n    return `${docs}  ${name}(${params}): Promise<AssembledTransaction<${outputType}>>;`;\n  }\n\n  private generateFromJSONMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n\n    return `  ${name} : this.txFromJSON<${outputType}>`;\n  }\n  /**\n   * Generate deploy method\n   */\n  private generateDeployMethod(\n    constructorFunc: xdr.ScSpecFunctionV0 | undefined,\n  ): string {\n    // If no constructor, generate deploy with no params\n    if (!constructorFunc) {\n      const params = this.formatConstructorParameters([]);\n      return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(null, options);\n  }`;\n    }\n    const inputs = constructorFunc.inputs().map((input) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n\n    const params = this.formatConstructorParameters(inputs);\n    const inputsDestructure =\n      inputs.length > 0 ? `{ ${inputs.map((i) => i.name).join(\", \")} }, ` : \"\";\n\n    return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(${inputsDestructure}options);\n  }`;\n  }\n\n  /**\n   * Format method parameters\n   */\n  private formatMethodParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\"options?: MethodOptions\");\n\n    return params.join(\", \");\n  }\n\n  /**\n   * Format constructor parameters\n   */\n  private formatConstructorParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\n      'options: MethodOptions & Omit<ContractClientOptions, \\'contractId\\'> & { wasmHash: Buffer | string; salt?: Buffer | Uint8Array; format?: \"hex\" | \"base64\"; address?: string; }',\n    );\n\n    return params.join(\", \");\n  }\n}\n"],"names":["params"],"mappings":"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"}

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

@@ -0,0 +1,34 @@
+export interface ConfigGenerateOptions {
+    contractName: string;
+}
+export interface Configs {
+    packageJson: string;
+    tsConfig: string;
+    gitignore: string;
+    readme: string;
+}
+/**
+ * Generates a complete TypeScript project structure with contract bindings
+ */
+export declare class ConfigGenerator {
+    /**
+     * Generate the complete TypeScript project
+     */
+    generate(options: ConfigGenerateOptions): Configs;
+    /**
+     * Generate package.json
+     */
+    private generatePackageJson;
+    /**
+     * Generate tsconfig.json
+     */
+    private generateTsConfig;
+    /**
+     * Generate .gitignore
+     */
+    private generateGitignore;
+    /**
+     * Generate README.md
+     */
+    private generateReadme;
+}

package/lib/esm/bindings/config.js

@@ -0,0 +1,137 @@
+class ConfigGenerator {
+  /**
+   * Generate the complete TypeScript project
+   */
+  generate(options) {
+    const { contractName } = options;
+    return {
+      packageJson: this.generatePackageJson(contractName),
+      tsConfig: this.generateTsConfig(),
+      gitignore: this.generateGitignore(),
+      readme: this.generateReadme(contractName)
+    };
+  }
+  /**
+   * Generate package.json
+   */
+  generatePackageJson(contractName) {
+    const generatedPackageJson = {
+      name: contractName.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
+      version: "0.0.1",
+      description: `Generated TypeScript bindings for ${contractName} Stellar contract`,
+      type: "module",
+      main: "dist/index.js",
+      types: "dist/index.d.ts",
+      scripts: {
+        build: "tsc"
+      },
+      dependencies: {
+        "@stellar/stellar-sdk": `^${"16.0.0"}`,
+        buffer: "6.0.3"
+      },
+      devDependencies: {
+        typescript: "^5.6.3"
+      }
+    };
+    return JSON.stringify(generatedPackageJson, null, 2);
+  }
+  /**
+   * Generate tsconfig.json
+   */
+  generateTsConfig() {
+    const tsConfig = {
+      compilerOptions: {
+        target: "ESNext",
+        module: "NodeNext",
+        moduleResolution: "nodenext",
+        declaration: true,
+        outDir: "./dist",
+        strictNullChecks: true,
+        skipLibCheck: true
+      },
+      include: ["src/*"]
+    };
+    return JSON.stringify(tsConfig, null, 2);
+  }
+  /**
+   * Generate .gitignore
+   */
+  generateGitignore() {
+    const gitignore = [
+      "# Dependencies",
+      "node_modules/",
+      "",
+      "# Build outputs",
+      "dist/",
+      "*.tgz",
+      "",
+      "# IDE",
+      ".vscode/",
+      ".idea/",
+      "",
+      "# OS",
+      ".DS_Store",
+      "Thumbs.db",
+      "",
+      "# Logs",
+      "*.log",
+      "npm-debug.log*",
+      "",
+      "# Runtime data",
+      "*.pid",
+      "*.seed"
+    ].join("\n");
+    return gitignore;
+  }
+  /**
+   * Generate README.md
+   */
+  generateReadme(contractName) {
+    const readme = [
+      `# ${contractName} Contract Bindings`,
+      "",
+      `TypeScript bindings for the ${contractName} Stellar smart contract.`,
+      "",
+      "## Installation",
+      "",
+      "```bash",
+      "npm install",
+      "```",
+      "",
+      "## Build",
+      "",
+      "```bash",
+      "npm run build",
+      "```",
+      "",
+      "## Usage",
+      "",
+      "```typescript",
+      'import { Client } from "./src";',
+      "",
+      "const client = new Client({",
+      '  contractId: "YOUR_CONTRACT_ID",',
+      '  rpcUrl: "https://soroban-testnet.stellar.org:443",',
+      '  networkPassphrase: "Test SDF Network ; September 2015",',
+      "});",
+      "",
+      "// Call contract methods",
+      "// const result = await client.methodName();",
+      "```",
+      "",
+      "## Generated Files",
+      "",
+      "- `src/index.ts` - Entry point exporting the Client",
+      "- `src/types.ts` - Type definitions for contract structs, enums, and unions",
+      "- `src/contract.ts` - Client implementation",
+      "- `tsconfig.json` - TypeScript configuration",
+      "- `package.json` - NPM package configuration",
+      "",
+      "This package was generated using the Js-Stellar-SDK contract binding generator."
+    ].join("\n");
+    return readme;
+  }
+}
+
+export { ConfigGenerator };
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sources":["../../../src/bindings/config.ts"],"sourcesContent":["// The SDK version is baked in at build time via babel-plugin-transform-define.\n// Previously this was `import packageJson from \"../../package.json\"`, which\n// failed at runtime in deeper build outputs (e.g. lib/axios) because the\n// relative path `../../package.json` resolved into the output tree rather\n// than the project root.\n\ndeclare const __PACKAGE_VERSION__: string;\n\nexport interface ConfigGenerateOptions {\n  contractName: string;\n}\n\nexport interface Configs {\n  packageJson: string;\n  tsConfig: string;\n  gitignore: string;\n  readme: string;\n}\n\n/**\n * Generates a complete TypeScript project structure with contract bindings\n */\nexport class ConfigGenerator {\n  /**\n   * Generate the complete TypeScript project\n   */\n  generate(options: ConfigGenerateOptions): Configs {\n    const { contractName } = options;\n\n    // Generate all project files\n    return {\n      packageJson: this.generatePackageJson(contractName),\n      tsConfig: this.generateTsConfig(),\n      gitignore: this.generateGitignore(),\n      readme: this.generateReadme(contractName),\n    };\n  }\n\n  /**\n   * Generate package.json\n   */\n  private generatePackageJson(contractName: string): string {\n    const generatedPackageJson = {\n      name: contractName.toLowerCase().replace(/[^a-z0-9-]/g, \"-\"),\n      version: \"0.0.1\",\n      description: `Generated TypeScript bindings for ${contractName} Stellar contract`,\n      type: \"module\",\n      main: \"dist/index.js\",\n      types: \"dist/index.d.ts\",\n      scripts: {\n        build: \"tsc\",\n      },\n      dependencies: {\n        \"@stellar/stellar-sdk\": `^${__PACKAGE_VERSION__}`,\n        buffer: \"6.0.3\",\n      },\n      devDependencies: {\n        typescript: \"^5.6.3\",\n      },\n    };\n\n    return JSON.stringify(generatedPackageJson, null, 2);\n  }\n\n  /**\n   * Generate tsconfig.json\n   */\n  private generateTsConfig(): string {\n    const tsConfig = {\n      compilerOptions: {\n        target: \"ESNext\",\n        module: \"NodeNext\",\n        moduleResolution: \"nodenext\",\n        declaration: true,\n        outDir: \"./dist\",\n        strictNullChecks: true,\n        skipLibCheck: true,\n      },\n      include: [\"src/*\"],\n    };\n\n    return JSON.stringify(tsConfig, null, 2);\n  }\n\n  /**\n   * Generate .gitignore\n   */\n  private generateGitignore(): string {\n    const gitignore = [\n      \"# Dependencies\",\n      \"node_modules/\",\n      \"\",\n      \"# Build outputs\",\n      \"dist/\",\n      \"*.tgz\",\n      \"\",\n      \"# IDE\",\n      \".vscode/\",\n      \".idea/\",\n      \"\",\n      \"# OS\",\n      \".DS_Store\",\n      \"Thumbs.db\",\n      \"\",\n      \"# Logs\",\n      \"*.log\",\n      \"npm-debug.log*\",\n      \"\",\n      \"# Runtime data\",\n      \"*.pid\",\n      \"*.seed\",\n    ].join(\"\\n\");\n\n    return gitignore;\n  }\n\n  /**\n   * Generate README.md\n   */\n  private generateReadme(contractName: string): string {\n    const readme = [\n      `# ${contractName} Contract Bindings`,\n      \"\",\n      `TypeScript bindings for the ${contractName} Stellar smart contract.`,\n      \"\",\n      \"## Installation\",\n      \"\",\n      \"```bash\",\n      \"npm install\",\n      \"```\",\n      \"\",\n      \"## Build\",\n      \"\",\n      \"```bash\",\n      \"npm run build\",\n      \"```\",\n      \"\",\n      \"## Usage\",\n      \"\",\n      \"```typescript\",\n      'import { Client } from \"./src\";',\n      \"\",\n      \"const client = new Client({\",\n      '  contractId: \"YOUR_CONTRACT_ID\",',\n      '  rpcUrl: \"https://soroban-testnet.stellar.org:443\",',\n      '  networkPassphrase: \"Test SDF Network ; September 2015\",',\n      \"});\",\n      \"\",\n      \"// Call contract methods\",\n      \"// const result = await client.methodName();\",\n      \"```\",\n      \"\",\n      \"## Generated Files\",\n      \"\",\n      \"- `src/index.ts` - Entry point exporting the Client\",\n      \"- `src/types.ts` - Type definitions for contract structs, enums, and unions\",\n      \"- `src/contract.ts` - Client implementation\",\n      \"- `tsconfig.json` - TypeScript configuration\",\n      \"- `package.json` - NPM package configuration\",\n      \"\",\n      \"This package was generated using the Js-Stellar-SDK contract binding generator.\",\n    ].join(\"\\n\");\n\n    return readme;\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,192 @@
+import { Spec } from "../contract/index.js";
+import { Server } from "../rpc/index.js";
+/**
+ * Options for generating TypeScript bindings.
+ */
+export type GenerateOptions = {
+    /**
+     * The name used for the generated package and client class.
+     * Should be in kebab-case (e.g., "my-contract").
+     */
+    contractName: string;
+};
+/**
+ * The output of the binding generation process.
+ *
+ * Contains all generated TypeScript source files and configuration files
+ * needed to create a standalone npm package for interacting with a Stellar contract.
+ */
+export type GeneratedBindings = {
+    /** The index.ts barrel export file that re-exports Client and types */
+    index: string;
+    /** The types.ts file containing TypeScript interfaces for contract structs, enums, and unions */
+    types: string;
+    /** The client.ts file containing the generated Client class with typed methods */
+    client: string;
+    /** The package.json for the generated npm package */
+    packageJson: string;
+    /** The tsconfig.json for TypeScript compilation */
+    tsConfig: string;
+    /** The README.md with usage documentation */
+    readme: string;
+    /** The .gitignore file for the generated package */
+    gitignore: string;
+};
+/**
+ * Generates TypeScript bindings for Stellar smart contracts.
+ *
+ * This class creates fully-typed TypeScript client code from a contract's specification,
+ * allowing developers to interact with Stellar smart contracts with full IDE support
+ * and compile-time type checking.
+ *
+ * @example
+ * ```ts
+ * // Create from a local WASM file
+ * const wasmBuffer = fs.readFileSync("./my_contract.wasm");
+ * const generator = await BindingGenerator.fromWasm(wasmBuffer);
+ * const bindings = generator.generate({ contractName: "my-contract" });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create from a contract deployed on the network
+ * const generator = await BindingGenerator.fromContractId(
+ *   "CABC...XYZ",
+ *   "https://soroban-testnet.stellar.org",
+ *   Networks.TESTNET
+ * );
+ * const bindings = generator.generate({ contractName: "my-contract" });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create from a Spec object directly
+ * const spec = new Spec(specEntries);
+ * const generator = BindingGenerator.fromSpec(spec);
+ * const bindings = generator.generate({ contractName: "my-contract" });
+ * ```
+ */
+export declare class BindingGenerator {
+    private spec;
+    /**
+     * Private constructor - use static factory methods instead.
+     *
+     * @param spec - The parsed contract specification
+     */
+    private constructor();
+    /**
+     * Creates a BindingGenerator from an existing Spec object.
+     *
+     * Use this when you already have a parsed contract specification,
+     * such as from manually constructed spec entries or from another source.
+     *
+     * @param spec - The contract specification containing function and type definitions
+     * @returns A new BindingGenerator instance
+     *
+     * @example
+     * ```ts
+     * const spec = new Spec(specEntries);
+     * const generator = BindingGenerator.fromSpec(spec);
+     * ```
+     */
+    static fromSpec(spec: Spec): BindingGenerator;
+    /**
+     * Creates a BindingGenerator from a WASM binary buffer.
+     *
+     * Parses the contract specification directly from the WASM file's custom section.
+     * This is the most common method when working with locally compiled contracts.
+     *
+     * @param wasmBuffer - The raw WASM binary as a Buffer
+     * @returns A Promise resolving to a new BindingGenerator instance
+     * @throws If the WASM file doesn't contain a valid contract spec
+     *
+     * @example
+     * ```ts
+     * const wasmBuffer = fs.readFileSync("./target/wasm32-unknown-unknown/release/my_contract.wasm");
+     * const generator = await BindingGenerator.fromWasm(wasmBuffer);
+     * ```
+     */
+    static fromWasm(wasmBuffer: Buffer): BindingGenerator;
+    /**
+     * Creates a BindingGenerator by fetching WASM from the network using its hash.
+     *
+     * Retrieves the WASM bytecode from Stellar RPC using the WASM hash,
+     * then parses the contract specification from it. Useful when you know
+     * the hash of an installed WASM but don't have the binary locally.
+     *
+     * @param wasmHash - The hex-encoded hash of the installed WASM blob
+     * @param rpcServer - The Stellar RPC server instance
+     * @returns A Promise resolving to a new BindingGenerator instance
+     * @throws If the WASM cannot be fetched or doesn't contain a valid spec
+     *
+     * @example
+     * ```ts
+     * const generator = await BindingGenerator.fromWasmHash(
+     *   "a1b2c3...xyz",
+     *   "https://soroban-testnet.stellar.org",
+     *   Networks.TESTNET
+     * );
+     * ```
+     */
+    static fromWasmHash(wasmHash: string, rpcServer: Server): Promise<BindingGenerator>;
+    /**
+     * Creates a BindingGenerator by fetching contract info from a deployed contract ID.
+     *
+     * Retrieves the contract's WASM from the network using the contract ID,
+     * then parses the specification. If the contract is a Stellar Asset Contract (SAC),
+     * returns a generator with the standard SAC specification.
+     *
+     * @param contractId - The contract ID (C... address) of the deployed contract
+     * @param rpcServer - The Stellar RPC server instance
+     * @returns A Promise resolving to a new BindingGenerator instance
+     * @throws If the contract cannot be found or fetched
+     *
+     * @example
+     * ```ts
+     * const generator = await BindingGenerator.fromContractId(
+     *   "CABC123...XYZ",
+     *   rpcServer
+     * );
+     * ```
+     */
+    static fromContractId(contractId: string, rpcServer: Server): Promise<BindingGenerator>;
+    /**
+     * Generates TypeScript bindings for the contract.
+     *
+     * Produces all the files needed for a standalone npm package:
+     * - `client.ts`: A typed Client class with methods for each contract function
+     * - `types.ts`: TypeScript interfaces for all contract types (structs, enums, unions)
+     * - `index.ts`: Barrel export file
+     * - `package.json`, `tsconfig.json`, `README.md`, `.gitignore`: Package configuration
+     *
+     * The generated code does not write to disk - use the returned strings
+     * to write files as needed.
+     *
+     * @param options - Configuration options for generation
+     *   - `contractName`: Required. The name for the generated package (kebab-case recommended)
+     * @returns An object containing all generated file contents as strings
+     * @throws If contractName is missing or empty
+     *
+     * @example
+     * ```ts
+     * const bindings = generator.generate({
+     *   contractName: "my-token",
+     *   contractAddress: "CABC...XYZ",
+     *   rpcUrl: "https://soroban-testnet.stellar.org",
+     *   networkPassphrase: Networks.TESTNET
+     * });
+     *
+     * // Write files to disk
+     * fs.writeFileSync("./src/client.ts", bindings.client);
+     * fs.writeFileSync("./src/types.ts", bindings.types);
+     * ```
+     */
+    generate(options: GenerateOptions): GeneratedBindings;
+    /**
+     * Validates that required generation options are provided.
+     *
+     * @param options - The options to validate
+     * @throws If contractName is missing or empty
+     */
+    private validateOptions;
+}