Backport: New install app payload

CHANGELOG.md

@@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Added
 ### Changed
+- Change `InstallAppRequest` type to adhere to the new format that includes the `roles_settings` field and removes
+the `membrane_proofs` field as membrane proofs are now specified as part of the `roles_settings`.
 ### Fixed
 ### Removed
 

doc-test-app-ws.ts

@@ -17,7 +17,6 @@ const appInfo = await adminWs.installApp({
   agent_key,
   path: "./test/e2e/fixture/test.happ",
   installed_app_id,
-  membrane_proofs: {},
 });
 await adminWs.enableApp({ installed_app_id });
 if (!(CellType.Provisioned in appInfo.cell_info[role_name][0])) {

doc-test-signal.ts

@@ -11,7 +11,6 @@ const appInfo = await adminWs.installApp({
   agent_key,
   path: "./test/e2e/fixture/test.happ",
   installed_app_id,
-  membrane_proofs: {},
 });
 await adminWs.enableApp({ installed_app_id });
 if (!(CellType.Provisioned in appInfo.cell_info[role_name][0])) {

docs/client.dnamodifiersopt.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [DnaModifiersOpt](./client.dnamodifiersopt.md)
+
+## DnaModifiersOpt type
+
+
+**Signature:**
+
+```typescript
+export type DnaModifiersOpt = {
+    network_seed?: NetworkSeed;
+    properties?: YamlProperties;
+    origin_time?: Timestamp;
+    quantum_time?: Duration;
+};
+```
+**References:** [NetworkSeed](./client.networkseed.md)<!-- -->, [YamlProperties](./client.yamlproperties.md)<!-- -->, [Timestamp](./client.timestamp.md)<!-- -->, [Duration](./client.duration.md)
+

docs/client.installapprequest.md

@@ -11,10 +11,10 @@
 export type InstallAppRequest = {
     agent_key?: AgentPubKey;
     installed_app_id?: InstalledAppId;
-    membrane_proofs: MemproofMap;
     network_seed?: NetworkSeed;
+    roles_settings?: RoleSettingsMap;
     ignore_genesis_failure?: boolean;
 } & AppBundleSource;
 ```
-**References:** [AgentPubKey](./client.agentpubkey.md)<!-- -->, [InstalledAppId](./client.installedappid.md)<!-- -->, [MemproofMap](./client.memproofmap.md)<!-- -->, [NetworkSeed](./client.networkseed.md)<!-- -->, [AppBundleSource](./client.appbundlesource.md)
+**References:** [AgentPubKey](./client.agentpubkey.md)<!-- -->, [InstalledAppId](./client.installedappid.md)<!-- -->, [NetworkSeed](./client.networkseed.md)<!-- -->, [RoleSettingsMap](./client.rolesettingsmap.md)<!-- -->, [AppBundleSource](./client.appbundlesource.md)
 

docs/client.md

@@ -1785,6 +1785,16 @@ This type is meant to be opaque
 
 
 
+</td></tr>
+<tr><td>
+
+[DnaModifiersOpt](./client.dnamodifiersopt.md)
+
+
+</td><td>
+
+
+
 </td></tr>
 <tr><td>
 
@@ -2619,6 +2629,26 @@ If the key could not be deleted from all cells, the call [RevokeAgentKeyRequest]
 
 
 
+</td></tr>
+<tr><td>
+
+[RoleSettings](./client.rolesettings.md)
+
+
+</td><td>
+
+
+
+</td></tr>
+<tr><td>
+
+[RoleSettingsMap](./client.rolesettingsmap.md)
+
+
+</td><td>
+
+
+
 </td></tr>
 <tr><td>
 
@@ -2809,6 +2839,17 @@ If the key could not be deleted from all cells, the call [RevokeAgentKeyRequest]
 
 
 
+</td></tr>
+<tr><td>
+
+[YamlProperties](./client.yamlproperties.md)
+
+
+</td><td>
+
+Any value that is serializable to a Yaml value
+
+
 </td></tr>
 <tr><td>
 

docs/client.memproofmap.md

@@ -9,8 +9,8 @@
 
 ```typescript
 export type MemproofMap = {
-    [key: string]: MembraneProof;
+    [key: RoleName]: MembraneProof;
 };
 ```
-**References:** [MembraneProof](./client.membraneproof.md)
+**References:** [RoleName](./client.rolename.md)<!-- -->, [MembraneProof](./client.membraneproof.md)
 

docs/client.rolesettings.md

@@ -0,0 +1,21 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [RoleSettings](./client.rolesettings.md)
+
+## RoleSettings type
+
+
+**Signature:**
+
+```typescript
+export type RoleSettings = {
+    type: "UseExisting";
+    cell_id: CellId;
+} | {
+    type: "Provisioned";
+    membrane_proof?: MembraneProof;
+    modifiers?: DnaModifiersOpt;
+};
+```
+**References:** [CellId](./client.cellid.md)<!-- -->, [MembraneProof](./client.membraneproof.md)<!-- -->, [DnaModifiersOpt](./client.dnamodifiersopt.md)
+

docs/client.rolesettingsmap.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [RoleSettingsMap](./client.rolesettingsmap.md)
+
+## RoleSettingsMap type
+
+
+**Signature:**
+
+```typescript
+export type RoleSettingsMap = {
+    [key: RoleName]: RoleSettings;
+};
+```
+**References:** [RoleName](./client.rolename.md)<!-- -->, [RoleSettings](./client.rolesettings.md)
+

docs/client.yamlproperties.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [YamlProperties](./client.yamlproperties.md)
+
+## YamlProperties type
+
+Any value that is serializable to a Yaml value
+
+**Signature:**
+
+```typescript
+export type YamlProperties = unknown;
+```

package.json

@@ -55,6 +55,7 @@
   "devDependencies": {
     "@microsoft/api-documenter": "^7.21.7",
     "@microsoft/api-extractor": "^7.34.4",
+    "@types/js-yaml": "4.0.9",
     "@types/libsodium-wrappers": "^0.7.11",
     "@types/lodash-es": "^4.17.6",
     "@types/tape": "^4.13.2",
@@ -65,7 +66,7 @@
     "eslint-config-prettier": "^8.10.0",
     "eslint-plugin-prettier": "^4.2.1",
     "eslint-plugin-tsdoc": "^0.2.17",
-    "js-yaml": "^3.14.1",
+    "js-yaml": "^4.1.0",
     "prettier": "^2.8.8",
     "rimraf": "^3.0.2",
     "tape": "^5.6.6",

src/api/admin/types.ts

@@ -155,7 +155,42 @@ export type MembraneProof = Uint8Array;
 /**
  * @public
  */
-export type MemproofMap = { [key: string]: MembraneProof };
+export type MemproofMap = { [key: RoleName]: MembraneProof };
+
+/**
+ * @public
+ */
+export type RoleSettingsMap = { [key: RoleName]: RoleSettings };
+
+/**
+ * @public
+ */
+export type RoleSettings =
+  | {
+      type: "UseExisting";
+      cell_id: CellId;
+    }
+  | {
+      type: "Provisioned";
+      membrane_proof?: MembraneProof;
+      modifiers?: DnaModifiersOpt;
+    };
+
+/**
+ *  @public
+ * Any value that is serializable to a Yaml value
+ */
+export type YamlProperties = unknown;
+
+/**
+ * @public
+ */
+export type DnaModifiersOpt = {
+  network_seed?: NetworkSeed;
+  properties?: YamlProperties;
+  origin_time?: Timestamp;
+  quantum_time?: Duration;
+};
 
 /**
  * @public
@@ -476,18 +511,17 @@ export type InstallAppRequest = {
    */
   installed_app_id?: InstalledAppId;
 
-  /**
-   * Include proof-of-membrane-membership data for cells that require it,
-   * keyed by the CellNick specified in the app bundle manifest.
-   */
-  membrane_proofs: MemproofMap;
-
   /**
    * Optional global network seed override.  If set will override the network seed value for all
    * DNAs in the bundle.
    */
   network_seed?: NetworkSeed;
 
+  /**
+   * Specify role specific settings or modifiers that will override any settings in the dna manifest.
+   */
+  roles_settings?: RoleSettingsMap;
+
   /**
    * Optional: If app installation fails due to genesis failure, normally the app will be immediately uninstalled.
    * When this flag is set, the app is left installed with empty cells intact. This can be useful for