Improve source/builder documentation

packages/cosmwasm/src/cosmwasmclient.ts

@@ -104,7 +104,18 @@ export interface Code {
   readonly creator: string;
   /** Hex-encoded sha256 hash of the code stored here */
   readonly checksum: string;
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 

packages/cosmwasm/src/restclient.ts

@@ -23,8 +23,18 @@ export interface CodeInfo {
   readonly creator: string;
   /** Hex-encoded sha256 hash of the code stored here */
   readonly data_hash: string;
-  // TODO: these are not supported in current wasmd
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 

packages/cosmwasm/src/signingcosmwasmclient.ts

@@ -83,9 +83,18 @@ const defaultFees: FeeTable = {
 };
 
 export interface UploadMeta {
-  /** The source URL */
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
-  /** The builder tag */
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 

packages/cosmwasm/types/cosmwasmclient.d.ts

@@ -64,7 +64,18 @@ export interface Code {
   readonly creator: string;
   /** Hex-encoded sha256 hash of the code stored here */
   readonly checksum: string;
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 export interface CodeDetails extends Code {

packages/cosmwasm/types/restclient.d.ts

@@ -6,7 +6,18 @@ export interface CodeInfo {
   readonly creator: string;
   /** Hex-encoded sha256 hash of the code stored here */
   readonly data_hash: string;
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 export interface CodeDetails extends CodeInfo {

packages/cosmwasm/types/signingcosmwasmclient.d.ts

@@ -14,9 +14,18 @@ export interface FeeTable {
   readonly changeAdmin: StdFee;
 }
 export interface UploadMeta {
-  /** The source URL */
+  /**
+   * An URL to a .tar.gz archive of the source code of the contract, which can be used to reproducibly build the Wasm bytecode.
+   *
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly source?: string;
-  /** The builder tag */
+  /**
+   * A docker image (including version) to reproducibly build the Wasm bytecode from the source code.
+   *
+   * @example ```cosmwasm/rust-optimizer:0.8.0```
+   * @see https://github.com/CosmWasm/cosmwasm-verify
+   */
   readonly builder?: string;
 }
 export interface UploadResult {