From 2d6670fbe4a7cbb9decb7d9a4b2a75aaa1d7e85e Mon Sep 17 00:00:00 2001
From: Cardano Wallet Documentation Bot <adrestia@cardano-foundation.io>
Date: Mon, 18 Sep 2023 10:23:07 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20Use=20reference=20input=20(#4114)=20<!-?=
 =?UTF-8?q?-=20Detail=20in=20a=20few=20bullet=20points=20the=20work=20acco?=
 =?UTF-8?q?mplished=20in=20this=20PR.=20Before=20you=20submit,=20don't=20f?=
 =?UTF-8?q?orget=20to:=20CODE-OF-CONDUCT.md=20CONTRIBUTING.md=20LICENSE=20?=
 =?UTF-8?q?MAINTAINERS.md=20README.md=20cabal.project=20default.nix=20dock?=
 =?UTF-8?q?er-compose.yml=20docs=20flake.lock=20flake.nix=20floskell.json?=
 =?UTF-8?q?=20fourmolu.yaml=20hie-direnv.yaml=20justfile=20lib=20nix=20pro?=
 =?UTF-8?q?totypes=20reports=20scripts=20shell.nix=20specifications=20test?=
 =?UTF-8?q?=20touch.me.CI=20weeder.dhall=20Make=20sure=20the=20GitHub=20PR?=
 =?UTF-8?q?=20fields=20are=20correct:=20=E2=9C=93=20Set=20a=20good=20Title?=
 =?UTF-8?q?=20for=20your=20PR.=20=E2=9C=93=20Assign=20yourself=20to=20the?=
 =?UTF-8?q?=20PR.=20=E2=9C=93=20Assign=20one=20or=20more=20reviewer(s).=20?=
 =?UTF-8?q?=E2=9C=93=20Link=20to=20a=20Jira=20issue,=20and/or=20other=20Gi?=
 =?UTF-8?q?tHub=20issues=20or=20PRs.=20=E2=9C=93=20In=20the=20PR=20descrip?=
 =?UTF-8?q?tion=20delete=20any=20empty=20sections=20and=20all=20text=20com?=
 =?UTF-8?q?mented=20in=20<!--,=20so=20that=20this=20text=20does=20not=20ap?=
 =?UTF-8?q?pear=20in=20merge=20commit=20messages.=20CODE-OF-CONDUCT.md=20C?=
 =?UTF-8?q?ONTRIBUTING.md=20LICENSE=20MAINTAINERS.md=20README.md=20cabal.p?=
 =?UTF-8?q?roject=20default.nix=20docker-compose.yml=20docs=20flake.lock?=
 =?UTF-8?q?=20flake.nix=20floskell.json=20fourmolu.yaml=20hie-direnv.yaml?=
 =?UTF-8?q?=20justfile=20lib=20nix=20prototypes=20reports=20scripts=20shel?=
 =?UTF-8?q?l.nix=20specifications=20test=20touch.me.CI=20weeder.dhall=20Do?=
 =?UTF-8?q?n't=20waste=20reviewers'=20time:=20=E2=9C=93=20If=20it's=20a=20?=
 =?UTF-8?q?draft,=20select=20the=20Create=20Draft=20PR=20option.=20?=
 =?UTF-8?q?=E2=9C=93=20Self-review=20your=20changes=20to=20make=20sure=20n?=
 =?UTF-8?q?othing=20unexpected=20slipped=20through.=20CODE-OF-CONDUCT.md?=
 =?UTF-8?q?=20CONTRIBUTING.md=20LICENSE=20MAINTAINERS.md=20README.md=20cab?=
 =?UTF-8?q?al.project=20default.nix=20docker-compose.yml=20docs=20flake.lo?=
 =?UTF-8?q?ck=20flake.nix=20floskell.json=20fourmolu.yaml=20hie-direnv.yam?=
 =?UTF-8?q?l=20justfile=20lib=20nix=20prototypes=20reports=20scripts=20she?=
 =?UTF-8?q?ll.nix=20specifications=20test=20touch.me.CI=20weeder.dhall=20T?=
 =?UTF-8?q?ry=20to=20make=20your=20intent=20clear:=20=E2=9C=93=20Write=20a?=
 =?UTF-8?q?=20good=20Description=20that=20explains=20what=20this=20PR=20is?=
 =?UTF-8?q?=20meant=20to=20do.=20=E2=9C=93=20Jira=20will=20detect=20and=20?=
 =?UTF-8?q?link=20to=20this=20PR=20once=20created,=20but=20you=20can=20als?=
 =?UTF-8?q?o=20link=20this=20PR=20in=20the=20description=20of=20the=20corr?=
 =?UTF-8?q?esponding=20Jira=20ticket.=20=E2=9C=93=20Highlight=20what=20Tes?=
 =?UTF-8?q?ting=20you=20have=20done.=20=E2=9C=93=20Acknowledge=20any=20cha?=
 =?UTF-8?q?nges=20required=20to=20the=20Documentation.=20-->=20-=20[x]=20u?=
 =?UTF-8?q?pdate=20`ApiMinBurnFromInput`=20to=20accommodate=20policy=20id?=
 =?UTF-8?q?=20-=20[x]=20update=20swagger=20and=20spec=20-=20[x]=20regenera?=
 =?UTF-8?q?te=20golden=20and=20make=20sure=20unit=20tests=20pass=20-=20[x]?=
 =?UTF-8?q?=20incorporate=20new=20`ApiMinBurnData`=20inside=20`constructTr?=
 =?UTF-8?q?ansaction`=20-=20[x]=20introduce=20ScriptSource=20-=20[x]=20han?=
 =?UTF-8?q?dle=20from=20input=20case=20to=20`mkUnsignedTx`=20-=20[x]=20adj?=
 =?UTF-8?q?ust=20`mkUnsignedTx`=20-=20[x]=20show=20the=20case=20in=20integ?=
 =?UTF-8?q?ration=20testing`=20###=20Comments=20builds=20on=20top=20of=20h?=
 =?UTF-8?q?ttps://github.com/cardano-foundation/cardano-wallet/pull/4086?=
 =?UTF-8?q?=20<!--=20Additional=20comments,=20links,=20or=20screenshots=20?=
 =?UTF-8?q?to=20attach,=20if=20any.=20-->=20###=20Issue=20Number=20adp-309?=
 =?UTF-8?q?0=20<!--=20Reference=20the=20Jira/GitHub=20issue=20that=20this?=
 =?UTF-8?q?=20PR=20relates=20to,=20and=20which=20requirements=20it=20tackl?=
 =?UTF-8?q?es.=20Note:=20Jira=20issues=20of=20the=20form=20ADP-=20will=20b?=
 =?UTF-8?q?e=20auto-linked.=20-->=20Source=20commit:=206157932b2b0bbfb1053?=
 =?UTF-8?q?20ec59cb7db89df62b230?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 api/edge/mint-burn.md | 18 ++++++++++++++++--
 api/edge/swagger.yaml |  2 ++
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/api/edge/mint-burn.md b/api/edge/mint-burn.md
index 1b2437aa1a2..e10802d8d99 100644
--- a/api/edge/mint-burn.md
+++ b/api/edge/mint-burn.md
@@ -33,9 +33,22 @@ Specifically:
     }
     ```
 
-2. Using a refence input that contains a minting script.
+2. Getting policy id using the same script template as in point 1. It is realized by calling `POST` on `/wallets/{walletId}/policy-id` endpoint with `POST` data:
 
-    In the `mint_burn` field, the array element contains `reference_input`. This field specifies a transaction input (pair of transaction ID and output index) which will be added as a reference input and is assumed to contain the minting script. (If the corresponding output was created using the method above, the appropriate output index is `0`).
+    ```
+    {
+      "policy_script_template":
+          { "all":
+             [ "cosigner#0",
+               { "active_from": 120 }
+             ]
+          }
+    }
+    ```
+
+3. Using a refence input that contains a minting script.
+
+    In the `mint_burn` field, the array element contains `reference_input` and `policy_id`. The first field specifies a transaction input (pair of transaction ID and output index) which will be added as a reference input and is assumed to contain the minting script. (If the corresponding output was created using the method above, the appropriate output index is `0`). The `policy_id` field is obtained from the response of request realized in point 2.
 
     Example `POST` data for the endpoint with reference input:
 
@@ -47,6 +60,7 @@ Specifically:
             { "id": "464917d2bac71df96269c2d7c34dcb83183b8a3a3253c06e9d6a8bd0681422c9",
               "index": 0
             },
+        "policy_id": "7191ae0e1286891fe5c027a5dc041b7401689938e18e14ec83cf74fb",
         "asset_name": "ab12",
         "operation":
             { "mint" :
diff --git a/api/edge/swagger.yaml b/api/edge/swagger.yaml
index b7e125046f0..61f06febbcb 100644
--- a/api/edge/swagger.yaml
+++ b/api/edge/swagger.yaml
@@ -3657,8 +3657,10 @@ components:
           required:
             - operation
             - reference_input
+            - policy_id
           properties:
             reference_input: *referenceInput
+            policy_id: *assetPolicyId
             asset_name: *assetName
             operation: *ApiMintBurnOperation