@stellar/stellar-sdk 16.0.1 → 16.1.0

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

@@ -35,30 +35,76 @@ export declare class Client {
      * Generates a Client instance from the provided ClientOptions and the contract's wasm hash.
      * The wasmHash can be provided in either hex or base64 format.
      *
+     * @typeParam T - An interface describing the contract's methods, used to type
+     * the returned client. Defaults to `unknown`, so calling without a type
+     * argument yields a plain `Client` (backward compatible). Provide it to get
+     * typed, autocompleted contract methods without code generation.
+     *
      * @param wasmHash - The hash of the contract's wasm binary, in either hex or base64 format.
      * @param options - The ClientOptions object containing the necessary configuration, including the rpcUrl.
      * @param format - (optional) The format of the provided wasmHash, either "hex" or "base64". Defaults to "hex".
      * @returns A Promise that resolves to a Client instance.
      * @throws If the provided options object does not contain an rpcUrl.
+     *
+     * @example
+     * ```ts
+     * interface MyContract {
+     *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+     * }
+     * const client = await contract.Client.fromWasmHash<MyContract>(hash, options);
+     * const tx = await client.increment(); // typed
+     * ```
      */
-    static fromWasmHash(wasmHash: Buffer | string, options: ClientOptions, format?: "hex" | "base64"): Promise<Client>;
+    static fromWasmHash<T = unknown>(wasmHash: Buffer | string, options: ClientOptions, format?: "hex" | "base64"): Promise<Client & T>;
     /**
      * Generates a Client instance from the provided ClientOptions and the contract's wasm binary.
      *
+     * @typeParam T - An interface describing the contract's methods, used to type
+     * the returned client. Defaults to `unknown`, so calling without a type
+     * argument yields a plain `Client` (backward compatible). Provide it to get
+     * typed, autocompleted contract methods without code generation.
+     *
      * @param wasm - The contract's wasm binary as a Buffer.
      * @param options - The ClientOptions object containing the necessary configuration.
      * @returns A Promise that resolves to a Client instance.
      * @throws If the contract spec cannot be obtained from the provided wasm binary.
+     *
+     * @example
+     * ```ts
+     * interface MyContract {
+     *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+     * }
+     * const client = await contract.Client.fromWasm<MyContract>(wasm, options);
+     * const tx = await client.increment(); // typed
+     * ```
      */
-    static fromWasm(wasm: Buffer, options: ClientOptions): Promise<Client>;
+    static fromWasm<T = unknown>(wasm: Buffer, options: ClientOptions): Promise<Client & T>;
     /**
      * Generates a Client instance from the provided ClientOptions, which must include the contractId and rpcUrl.
      *
+     * If the contract is a built-in Stellar Asset Contract (SAC), the embedded
+     * SAC spec is used instead of downloading Wasm, since a SAC has no Wasm
+     * executable on-chain.
+     *
+     * @typeParam T - An interface describing the contract's methods, used to type
+     * the returned client. Defaults to `unknown`, so calling without a type
+     * argument yields a plain `Client` (backward compatible). Provide it to get
+     * typed, autocompleted contract methods without code generation.
+     *
      * @param options - The ClientOptions object containing the necessary configuration, including the contractId and rpcUrl.
      * @returns A Promise that resolves to a Client instance.
      * @throws If the provided options object does not contain both rpcUrl and contractId.
+     *
+     * @example
+     * ```ts
+     * interface MyContract {
+     *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+     * }
+     * const client = await contract.Client.from<MyContract>(options);
+     * const tx = await client.increment(); // typed
+     * ```
      */
-    static from(options: ClientOptions): Promise<Client>;
+    static from<T = unknown>(options: ClientOptions): Promise<Client & T>;
     txFromJSON: <T>(json: string) => AssembledTransaction<T>;
     txFromXDR: <T>(xdrBase64: string) => AssembledTransaction<T>;
 }

package/lib/esm/contract/client.js

@@ -4,7 +4,7 @@ import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr
 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 '../base/generated/curr_generated.js';
+import types from '../base/generated/curr_generated.js';
 import '@noble/hashes/sha2.js';
 import '../base/signing.js';
 import '../base/keypair.js';
@@ -105,11 +105,25 @@ class Client {
    * Generates a Client instance from the provided ClientOptions and the contract's wasm hash.
    * The wasmHash can be provided in either hex or base64 format.
    *
+   * @typeParam T - An interface describing the contract's methods, used to type
+   * the returned client. Defaults to `unknown`, so calling without a type
+   * argument yields a plain `Client` (backward compatible). Provide it to get
+   * typed, autocompleted contract methods without code generation.
+   *
    * @param wasmHash - The hash of the contract's wasm binary, in either hex or base64 format.
    * @param options - The ClientOptions object containing the necessary configuration, including the rpcUrl.
    * @param format - (optional) The format of the provided wasmHash, either "hex" or "base64". Defaults to "hex".
    * @returns A Promise that resolves to a Client instance.
    * @throws If the provided options object does not contain an rpcUrl.
+   *
+   * @example
+   * ```ts
+   * interface MyContract {
+   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+   * }
+   * const client = await contract.Client.fromWasmHash<MyContract>(hash, options);
+   * const tx = await client.increment(); // typed
+   * ```
    */
   static async fromWasmHash(wasmHash, options, format = "hex") {
     if (!options || !options.rpcUrl) {
@@ -126,10 +140,24 @@ class Client {
   /**
    * Generates a Client instance from the provided ClientOptions and the contract's wasm binary.
    *
+   * @typeParam T - An interface describing the contract's methods, used to type
+   * the returned client. Defaults to `unknown`, so calling without a type
+   * argument yields a plain `Client` (backward compatible). Provide it to get
+   * typed, autocompleted contract methods without code generation.
+   *
    * @param wasm - The contract's wasm binary as a Buffer.
    * @param options - The ClientOptions object containing the necessary configuration.
    * @returns A Promise that resolves to a Client instance.
    * @throws If the contract spec cannot be obtained from the provided wasm binary.
+   *
+   * @example
+   * ```ts
+   * interface MyContract {
+   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+   * }
+   * const client = await contract.Client.fromWasm<MyContract>(wasm, options);
+   * const tx = await client.increment(); // typed
+   * ```
    */
   static async fromWasm(wasm, options) {
     const spec = await Spec.fromWasm(wasm);
@@ -138,20 +166,45 @@ class Client {
   /**
    * Generates a Client instance from the provided ClientOptions, which must include the contractId and rpcUrl.
    *
+   * If the contract is a built-in Stellar Asset Contract (SAC), the embedded
+   * SAC spec is used instead of downloading Wasm, since a SAC has no Wasm
+   * executable on-chain.
+   *
+   * @typeParam T - An interface describing the contract's methods, used to type
+   * the returned client. Defaults to `unknown`, so calling without a type
+   * argument yields a plain `Client` (backward compatible). Provide it to get
+   * typed, autocompleted contract methods without code generation.
+   *
    * @param options - The ClientOptions object containing the necessary configuration, including the contractId and rpcUrl.
    * @returns A Promise that resolves to a Client instance.
    * @throws If the provided options object does not contain both rpcUrl and contractId.
+   *
+   * @example
+   * ```ts
+   * interface MyContract {
+   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;
+   * }
+   * const client = await contract.Client.from<MyContract>(options);
+   * const tx = await client.increment(); // typed
+   * ```
    */
   static async from(options) {
     if (!options || !options.rpcUrl || !options.contractId) {
       throw new TypeError("options must contain rpcUrl and contractId");
     }
     const { rpcUrl, contractId, allowHttp, headers } = options;
-    const server = new RpcServer(rpcUrl, {
+    const server = options.server ?? new RpcServer(rpcUrl, {
       allowHttp,
       headers
     });
-    const wasm = await server.getContractWasmByContractId(contractId);
+    const instance = await server.getContractInstance(contractId);
+    if (instance.executable().switch() === types.ContractExecutableType.contractExecutableStellarAsset()) {
+      const { SAC_SPEC } = await import('../bindings/sac-spec.js');
+      return new Client(new Spec(SAC_SPEC), options);
+    }
+    const wasm = await server.getContractWasmByHash(
+      instance.executable().wasmHash()
+    );
     return Client.fromWasm(wasm, options);
   }
   txFromJSON = (json) => {

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

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/contract/client.ts"],"sourcesContent":["import { Operation, xdr, Address } from \"../base/index.js\";\nimport { Spec } from \"./spec.js\";\nimport { Server } from \"../rpc/index.js\";\nimport { AssembledTransaction } from \"./assembled_transaction.js\";\nimport type { ClientOptions, MethodOptions } from \"./types.js\";\nimport { sanitizeIdentifier } from \"../bindings/utils.js\";\n\nconst CONSTRUCTOR_FUNC = \"__constructor\";\n\nasync function specFromWasmHash(\n  wasmHash: Buffer | string,\n  options: Server.Options & { rpcUrl: string },\n  format: \"hex\" | \"base64\" = \"hex\",\n): Promise<Spec> {\n  if (!options || !options.rpcUrl) {\n    throw new TypeError(\"options must contain rpcUrl\");\n  }\n  const { rpcUrl, allowHttp, headers } = options;\n  const serverOpts: Server.Options = { allowHttp, headers };\n  const server = new Server(rpcUrl, serverOpts);\n  const wasm = await server.getContractWasmByHash(wasmHash, format);\n  return Spec.fromWasm(wasm);\n}\n\n/**\n * Generate a class from the contract spec that where each contract method\n * gets included with an identical name.\n *\n * Each method returns an {@link contract.AssembledTransaction | AssembledTransaction} that can\n * be used to modify, simulate, decode results, and possibly sign, & submit the\n * transaction.\n *\n *\n * @param spec - {@link Spec} to construct a Client for\n * @param options - see {@link ClientOptions}\n */\nexport class Client {\n  static async deploy<T = Client>(\n    /** Constructor/Initialization Args for the contract's `__constructor` method */\n    args: Record<string, any> | null,\n    /** Options for initializing a Client as well as for calling a method, with extras specific to deploying. */\n    options: MethodOptions &\n      Omit<ClientOptions, \"contractId\"> & {\n        /** The hash of the Wasm blob, which must already be installed on-chain. */\n        wasmHash: Buffer | string;\n        /** Salt used to generate the contract's ID. Passed through to {@link Operation.createCustomContract}. Default: random. */\n        salt?: Buffer | Uint8Array;\n        /** The format used to decode `wasmHash`, if it's provided as a string. */\n        format?: \"hex\" | \"base64\";\n        /** The address to use to deploy the custom contract */\n        address?: string;\n      },\n  ): Promise<AssembledTransaction<T>> {\n    const {\n      wasmHash,\n      salt,\n      format,\n      fee,\n      timeoutInSeconds,\n      simulate,\n      ...clientOptions\n    } = options;\n    const spec = await specFromWasmHash(wasmHash, clientOptions, format);\n\n    const operation = Operation.createCustomContract({\n      address: new Address(options.address || options.publicKey!),\n      wasmHash:\n        typeof wasmHash === \"string\"\n          ? Buffer.from(wasmHash, format ?? \"hex\")\n          : (wasmHash as Buffer),\n      salt,\n      constructorArgs: args\n        ? spec.funcArgsToScVals(CONSTRUCTOR_FUNC, args)\n        : [],\n    });\n\n    return AssembledTransaction.buildWithOp(operation, {\n      fee,\n      timeoutInSeconds,\n      simulate,\n      ...clientOptions,\n      contractId: \"ignored\",\n      method: CONSTRUCTOR_FUNC,\n      parseResultXdr: (result) =>\n        new Client(spec, {\n          ...clientOptions,\n          contractId: Address.fromScVal(result).toString(),\n        }),\n    }) as unknown as AssembledTransaction<T>;\n  }\n\n  constructor(\n    public readonly spec: Spec,\n    public readonly options: ClientOptions,\n  ) {\n    // Ensure we have a server to reuse for all AssembledTransactions\n    if (options.server === undefined) {\n      const { allowHttp, headers } = options;\n      options.server = new Server(options.rpcUrl, {\n        allowHttp,\n        headers,\n      });\n    }\n\n    this.spec.funcs().forEach((xdrFn) => {\n      const method = xdrFn.name().toString();\n      if (method === CONSTRUCTOR_FUNC) {\n        return;\n      }\n      const assembleTransaction = (\n        args?: Record<string, any>,\n        methodOptions?: MethodOptions,\n      ) =>\n        AssembledTransaction.build({\n          method,\n          args: args && spec.funcArgsToScVals(method, args),\n          ...options,\n          ...methodOptions,\n          errorTypes: spec.errorCases().reduce(\n            (acc, curr) => ({\n              ...acc,\n              [curr.value()]: { message: curr.doc().toString() },\n            }),\n            {} as Pick<ClientOptions, \"errorTypes\">,\n          ),\n          parseResultXdr: (result: xdr.ScVal) =>\n            spec.funcResToNative(method, result),\n        });\n\n      // @ts-expect-error error TS7053: Element implicitly has an 'any' type\n      this[sanitizeIdentifier(method)] =\n        spec.getFunc(method).inputs().length === 0\n          ? (opts?: MethodOptions) => assembleTransaction(undefined, opts)\n          : assembleTransaction;\n    });\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions and the contract's wasm hash.\n   * The wasmHash can be provided in either hex or base64 format.\n   *\n   * @param wasmHash - The hash of the contract's wasm binary, in either hex or base64 format.\n   * @param options - The ClientOptions object containing the necessary configuration, including the rpcUrl.\n   * @param format - (optional) The format of the provided wasmHash, either \"hex\" or \"base64\". Defaults to \"hex\".\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the provided options object does not contain an rpcUrl.\n   */\n  static async fromWasmHash(\n    wasmHash: Buffer | string,\n    options: ClientOptions,\n    format: \"hex\" | \"base64\" = \"hex\",\n  ): Promise<Client> {\n    if (!options || !options.rpcUrl) {\n      throw new TypeError(\"options must contain rpcUrl\");\n    }\n    const { rpcUrl, allowHttp, headers } = options;\n    const server =\n      options.server ??\n      new Server(rpcUrl, {\n        allowHttp,\n        headers,\n      });\n    const wasm = await server.getContractWasmByHash(wasmHash, format);\n\n    return Client.fromWasm(wasm, options);\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions and the contract's wasm binary.\n   *\n   * @param wasm - The contract's wasm binary as a Buffer.\n   * @param options - The ClientOptions object containing the necessary configuration.\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the contract spec cannot be obtained from the provided wasm binary.\n   */\n  static async fromWasm(wasm: Buffer, options: ClientOptions): Promise<Client> {\n    const spec = await Spec.fromWasm(wasm);\n    return new Client(spec, options);\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions, which must include the contractId and rpcUrl.\n   *\n   * @param options - The ClientOptions object containing the necessary configuration, including the contractId and rpcUrl.\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the provided options object does not contain both rpcUrl and contractId.\n   */\n  static async from(options: ClientOptions): Promise<Client> {\n    if (!options || !options.rpcUrl || !options.contractId) {\n      throw new TypeError(\"options must contain rpcUrl and contractId\");\n    }\n    const { rpcUrl, contractId, allowHttp, headers } = options;\n    const server = new Server(rpcUrl, {\n      allowHttp,\n      headers,\n    });\n    const wasm = await server.getContractWasmByContractId(contractId);\n    return Client.fromWasm(wasm, options);\n  }\n\n  txFromJSON = <T>(json: string): AssembledTransaction<T> => {\n    const { method, ...tx } = JSON.parse(json);\n    return AssembledTransaction.fromJSON(\n      {\n        ...this.options,\n        method,\n        parseResultXdr: (result: xdr.ScVal) =>\n          this.spec.funcResToNative(method, result),\n      },\n      tx,\n    );\n  };\n\n  txFromXDR = <T>(xdrBase64: string): AssembledTransaction<T> =>\n    AssembledTransaction.fromXDR(this.options, xdrBase64, this.spec);\n}\n"],"names":["Server"],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../../src/contract/client.ts"],"sourcesContent":["import { Operation, xdr, Address } from \"../base/index.js\";\nimport { Spec } from \"./spec.js\";\nimport { Server } from \"../rpc/index.js\";\nimport { AssembledTransaction } from \"./assembled_transaction.js\";\nimport type { ClientOptions, MethodOptions } from \"./types.js\";\nimport { sanitizeIdentifier } from \"../bindings/utils.js\";\n\nconst CONSTRUCTOR_FUNC = \"__constructor\";\n\nasync function specFromWasmHash(\n  wasmHash: Buffer | string,\n  options: Server.Options & { rpcUrl: string },\n  format: \"hex\" | \"base64\" = \"hex\",\n): Promise<Spec> {\n  if (!options || !options.rpcUrl) {\n    throw new TypeError(\"options must contain rpcUrl\");\n  }\n  const { rpcUrl, allowHttp, headers } = options;\n  const serverOpts: Server.Options = { allowHttp, headers };\n  const server = new Server(rpcUrl, serverOpts);\n  const wasm = await server.getContractWasmByHash(wasmHash, format);\n  return Spec.fromWasm(wasm);\n}\n\n/**\n * Generate a class from the contract spec that where each contract method\n * gets included with an identical name.\n *\n * Each method returns an {@link contract.AssembledTransaction | AssembledTransaction} that can\n * be used to modify, simulate, decode results, and possibly sign, & submit the\n * transaction.\n *\n *\n * @param spec - {@link Spec} to construct a Client for\n * @param options - see {@link ClientOptions}\n */\nexport class Client {\n  static async deploy<T = Client>(\n    /** Constructor/Initialization Args for the contract's `__constructor` method */\n    args: Record<string, any> | null,\n    /** Options for initializing a Client as well as for calling a method, with extras specific to deploying. */\n    options: MethodOptions &\n      Omit<ClientOptions, \"contractId\"> & {\n        /** The hash of the Wasm blob, which must already be installed on-chain. */\n        wasmHash: Buffer | string;\n        /** Salt used to generate the contract's ID. Passed through to {@link Operation.createCustomContract}. Default: random. */\n        salt?: Buffer | Uint8Array;\n        /** The format used to decode `wasmHash`, if it's provided as a string. */\n        format?: \"hex\" | \"base64\";\n        /** The address to use to deploy the custom contract */\n        address?: string;\n      },\n  ): Promise<AssembledTransaction<T>> {\n    const {\n      wasmHash,\n      salt,\n      format,\n      fee,\n      timeoutInSeconds,\n      simulate,\n      ...clientOptions\n    } = options;\n    const spec = await specFromWasmHash(wasmHash, clientOptions, format);\n\n    const operation = Operation.createCustomContract({\n      address: new Address(options.address || options.publicKey!),\n      wasmHash:\n        typeof wasmHash === \"string\"\n          ? Buffer.from(wasmHash, format ?? \"hex\")\n          : (wasmHash as Buffer),\n      salt,\n      constructorArgs: args\n        ? spec.funcArgsToScVals(CONSTRUCTOR_FUNC, args)\n        : [],\n    });\n\n    return AssembledTransaction.buildWithOp(operation, {\n      fee,\n      timeoutInSeconds,\n      simulate,\n      ...clientOptions,\n      contractId: \"ignored\",\n      method: CONSTRUCTOR_FUNC,\n      parseResultXdr: (result) =>\n        new Client(spec, {\n          ...clientOptions,\n          contractId: Address.fromScVal(result).toString(),\n        }),\n    }) as unknown as AssembledTransaction<T>;\n  }\n\n  constructor(\n    public readonly spec: Spec,\n    public readonly options: ClientOptions,\n  ) {\n    // Ensure we have a server to reuse for all AssembledTransactions\n    if (options.server === undefined) {\n      const { allowHttp, headers } = options;\n      options.server = new Server(options.rpcUrl, {\n        allowHttp,\n        headers,\n      });\n    }\n\n    this.spec.funcs().forEach((xdrFn) => {\n      const method = xdrFn.name().toString();\n      if (method === CONSTRUCTOR_FUNC) {\n        return;\n      }\n      const assembleTransaction = (\n        args?: Record<string, any>,\n        methodOptions?: MethodOptions,\n      ) =>\n        AssembledTransaction.build({\n          method,\n          args: args && spec.funcArgsToScVals(method, args),\n          ...options,\n          ...methodOptions,\n          errorTypes: spec.errorCases().reduce(\n            (acc, curr) => ({\n              ...acc,\n              [curr.value()]: { message: curr.doc().toString() },\n            }),\n            {} as Pick<ClientOptions, \"errorTypes\">,\n          ),\n          parseResultXdr: (result: xdr.ScVal) =>\n            spec.funcResToNative(method, result),\n        });\n\n      // @ts-expect-error error TS7053: Element implicitly has an 'any' type\n      this[sanitizeIdentifier(method)] =\n        spec.getFunc(method).inputs().length === 0\n          ? (opts?: MethodOptions) => assembleTransaction(undefined, opts)\n          : assembleTransaction;\n    });\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions and the contract's wasm hash.\n   * The wasmHash can be provided in either hex or base64 format.\n   *\n   * @typeParam T - An interface describing the contract's methods, used to type\n   * the returned client. Defaults to `unknown`, so calling without a type\n   * argument yields a plain `Client` (backward compatible). Provide it to get\n   * typed, autocompleted contract methods without code generation.\n   *\n   * @param wasmHash - The hash of the contract's wasm binary, in either hex or base64 format.\n   * @param options - The ClientOptions object containing the necessary configuration, including the rpcUrl.\n   * @param format - (optional) The format of the provided wasmHash, either \"hex\" or \"base64\". Defaults to \"hex\".\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the provided options object does not contain an rpcUrl.\n   *\n   * @example\n   * ```ts\n   * interface MyContract {\n   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;\n   * }\n   * const client = await contract.Client.fromWasmHash<MyContract>(hash, options);\n   * const tx = await client.increment(); // typed\n   * ```\n   */\n  static async fromWasmHash<T = unknown>(\n    wasmHash: Buffer | string,\n    options: ClientOptions,\n    format: \"hex\" | \"base64\" = \"hex\",\n  ): Promise<Client & T> {\n    if (!options || !options.rpcUrl) {\n      throw new TypeError(\"options must contain rpcUrl\");\n    }\n    const { rpcUrl, allowHttp, headers } = options;\n    const server =\n      options.server ??\n      new Server(rpcUrl, {\n        allowHttp,\n        headers,\n      });\n    const wasm = await server.getContractWasmByHash(wasmHash, format);\n\n    return Client.fromWasm<T>(wasm, options);\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions and the contract's wasm binary.\n   *\n   * @typeParam T - An interface describing the contract's methods, used to type\n   * the returned client. Defaults to `unknown`, so calling without a type\n   * argument yields a plain `Client` (backward compatible). Provide it to get\n   * typed, autocompleted contract methods without code generation.\n   *\n   * @param wasm - The contract's wasm binary as a Buffer.\n   * @param options - The ClientOptions object containing the necessary configuration.\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the contract spec cannot be obtained from the provided wasm binary.\n   *\n   * @example\n   * ```ts\n   * interface MyContract {\n   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;\n   * }\n   * const client = await contract.Client.fromWasm<MyContract>(wasm, options);\n   * const tx = await client.increment(); // typed\n   * ```\n   */\n  static async fromWasm<T = unknown>(\n    wasm: Buffer,\n    options: ClientOptions,\n  ): Promise<Client & T> {\n    const spec = await Spec.fromWasm(wasm);\n    return new Client(spec, options) as unknown as Client & T;\n  }\n\n  /**\n   * Generates a Client instance from the provided ClientOptions, which must include the contractId and rpcUrl.\n   *\n   * If the contract is a built-in Stellar Asset Contract (SAC), the embedded\n   * SAC spec is used instead of downloading Wasm, since a SAC has no Wasm\n   * executable on-chain.\n   *\n   * @typeParam T - An interface describing the contract's methods, used to type\n   * the returned client. Defaults to `unknown`, so calling without a type\n   * argument yields a plain `Client` (backward compatible). Provide it to get\n   * typed, autocompleted contract methods without code generation.\n   *\n   * @param options - The ClientOptions object containing the necessary configuration, including the contractId and rpcUrl.\n   * @returns A Promise that resolves to a Client instance.\n   * @throws If the provided options object does not contain both rpcUrl and contractId.\n   *\n   * @example\n   * ```ts\n   * interface MyContract {\n   *   increment: (opts?: MethodOptions) => Promise<AssembledTransaction<number>>;\n   * }\n   * const client = await contract.Client.from<MyContract>(options);\n   * const tx = await client.increment(); // typed\n   * ```\n   */\n  static async from<T = unknown>(options: ClientOptions): Promise<Client & T> {\n    if (!options || !options.rpcUrl || !options.contractId) {\n      throw new TypeError(\"options must contain rpcUrl and contractId\");\n    }\n\n    const { rpcUrl, contractId, allowHttp, headers } = options;\n    const server =\n      options.server ??\n      new Server(rpcUrl, {\n        allowHttp,\n        headers,\n      });\n\n    const instance = await server.getContractInstance(contractId);\n\n    if (\n      instance.executable().switch() ===\n      xdr.ContractExecutableType.contractExecutableStellarAsset()\n    ) {\n      // Lazily load the (large) embedded SAC spec so bundlers can code-split\n      // it out of the common path; it's only needed for built-in SACs.\n      const { SAC_SPEC } = await import(\"../bindings/sac-spec.js\");\n      return new Client(new Spec(SAC_SPEC), options) as unknown as Client & T;\n    }\n\n    const wasm = await server.getContractWasmByHash(\n      instance.executable().wasmHash(),\n    );\n\n    return Client.fromWasm<T>(wasm, options);\n  }\n\n  txFromJSON = <T>(json: string): AssembledTransaction<T> => {\n    const { method, ...tx } = JSON.parse(json);\n    return AssembledTransaction.fromJSON(\n      {\n        ...this.options,\n        method,\n        parseResultXdr: (result: xdr.ScVal) =>\n          this.spec.funcResToNative(method, result),\n      },\n      tx,\n    );\n  };\n\n  txFromXDR = <T>(xdrBase64: string): AssembledTransaction<T> =>\n    AssembledTransaction.fromXDR(this.options, xdrBase64, this.spec);\n}\n"],"names":["Server","xdr"],"mappings":"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"}

package/lib/esm/contract/spec.js

@@ -15,7 +15,7 @@ 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 { nativeToScVal } from '../base/scval.js';
 import { scValToBigInt } from '../base/numbers/index.js';
 import { Err, Ok } from './rust_result.js';
 import { processSpecEntryStream } from './utils.js';
@@ -614,6 +614,9 @@ class Spec {
       }
       return this.nativeToScVal(val, opt.valueType());
     }
+    if (value === types.ScSpecType.scSpecTypeVal().value) {
+      return nativeToScVal(val);
+    }
     switch (typeof val) {
       case "object": {
         if (val === null) {
@@ -704,7 +707,7 @@ class Spec {
               );
           }
         }
-        if (val.constructor === Map) {
+        if (val instanceof Map) {
           if (value !== types.ScSpecType.scSpecTypeMap().value) {
             throw new TypeError(`Type ${ty} was not map, but value was Map`);
           }
@@ -722,7 +725,8 @@ class Spec {
           }
           return types.ScVal.scvMap(entries);
         }
-        if ((val.constructor?.name ?? "") !== "Object") {
+        const proto = Object.getPrototypeOf(val);
+        if (proto !== Object.prototype && proto !== null) {
           throw new TypeError(
             `cannot interpret ${val.constructor?.name} value as ScVal (${JSON.stringify(val)})`
           );