From 90573acd6c01cda3e139782715cc91268982bf99 Mon Sep 17 00:00:00 2001 From: Joseph Fajen Date: Fri, 19 Jan 2024 09:23:51 -0800 Subject: [PATCH] further edits --- docs/platform-and-architecture/roles-in-marlowe.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/platform-and-architecture/roles-in-marlowe.md b/docs/platform-and-architecture/roles-in-marlowe.md index acb8928..4d269a3 100644 --- a/docs/platform-and-architecture/roles-in-marlowe.md +++ b/docs/platform-and-architecture/roles-in-marlowe.md @@ -11,7 +11,7 @@ These roles are uniquely identified using role tokens. ## Role tokens -Role tokens are used to identify roles to authorize transactions providing additional security and flexibility for your smart contracts. They are handled implicitly by Marlowe Runtime. +Participants hold role tokens in their wallets. Role tokens are used to identify roles to authorize transactions providing additional security and flexibility for your smart contracts. They are handled implicitly by Marlowe Runtime. Each participant in a Marlowe contract has a role and each role has its own token. These tokens can be transferred between users in a peer-to-peer manner, allowing a participant to give their role to someone else. @@ -19,6 +19,8 @@ There could be one or many tokens for a specific role. Role tokens are distributed at contract initialization. +Participants who want to make a transaction include their role token as input. The token doesn’t stay with the script or go anywhere else; it simply passes through the script and returns to the participant, allowing them to authorize another transaction. + You can view these role tokens in your wallet under NFTs/Assets with a name reflective of the name specified for the role in the smart contract. (In Nami, Lace does not carry the name over from the DApp to the asset.) When designating an address after launching the contract, the open roles feature is used.