chore::> confidential escrow example - LFX25

[PsychoPunkSage]

What this PR does / why we need it:
This PR is meant to introduce a new example (using FPC & cc-tools) called confidential escrow.

Which issue(s) this PR fixes:

NIL

Special notes for your reviewer:
TBA

[samuelvenzi]

Instead of receiving the uuid section of the @key of the asset you could receive directly a reference to the asset. The argument could be:

		{
			Tag:         "digitalAsset",
			Label:       "Digital Asset",
			Description: "Digital Asset to read",
			DataType:    "->digitalAsset",
			Required:    true,
		},

This allows you to call the transaction with two options of body:

{
    "@assetType": "digitalAsset",
    "@key": "digitalAsset:[UUID]",
}

Or

{
    "@assetType": "digitalAsset",
    "symbol": "[TokenSymbol]",
}

This would the "CC-Tools" way of doing it.

[samuelvenzi]

Also, the argument would "arrive" in the transaction routine already validated by CC-Tools.

[samuelvenzi]

When you do this, you are bypassing CC-Tools key formation, which is fine if you know that the UUID is correct.

In conjunction to my comment above, you wouldn't need to do this because the req map would have already a assets.Key type with the validated key (no matter which argument you used: @key or key properties).

[samuelvenzi]

CC-Tools provides an UpdateAsset function that could be used here. The update function receives a map with only the fields you'd like to update. No need to reassemble the full asset with fields that are not being updated. I'd suggest replacing this Put with the Update.