Afrz: ASA Global Freeze

cmd/goal/account.go

@@ -695,6 +695,8 @@ func printAccountInfo(client libgoal.Client, address string, onlyShowAssetIDs bo
 		frozen := ""
 		if assetHolding.IsFrozen {
 			frozen = " (frozen)"
+		} else if assetParams.Params.Frozen != nil {
+			frozen = " (globally frozen)"
 		}
 
 		fmt.Fprintf(report, "\tID %d, %s, balance %s %s%s\n", assetHolding.AssetID, assetName, amount, unitName, frozen)

cmd/goal/asset.go

@@ -115,7 +115,6 @@ func init() {
 	freezeAssetCmd.Flags().StringVar(&account, "account", "", "Account address to freeze/unfreeze")
 	freezeAssetCmd.Flags().BoolVar(&assetFrozen, "freeze", false, "Freeze or unfreeze")
 	freezeAssetCmd.MarkFlagRequired("freezer")
-	freezeAssetCmd.MarkFlagRequired("account")
 	freezeAssetCmd.MarkFlagRequired("freeze")
 
 	optinAssetCmd.Flags().StringVar(&assetUnitName, "asset", "", "Unit name of the asset being accepted")
@@ -806,6 +805,7 @@ var infoAssetCmd = &cobra.Command{
 		fmt.Printf("Issued:           %s %s\n", assetDecimalsFmt(asset.Params.Total-res.Amount, asset.Params.Decimals), derefString(asset.Params.UnitName))
 		fmt.Printf("Decimals:         %d\n", asset.Params.Decimals)
 		fmt.Printf("Default frozen:   %v\n", derefBool(asset.Params.DefaultFrozen))
+		fmt.Printf("Global freeze:    %v\n", derefBool(asset.Params.Frozen))
 		fmt.Printf("Manager address:  %s\n", derefString(asset.Params.Manager))
 		if reserveEmpty {
 			fmt.Printf("Reserve address:  %s (Empty. Defaulting to creator)\n", derefString(asset.Params.Reserve))

config/consensus.go

@@ -550,6 +550,11 @@ type ConsensusParams struct {
 
 	// Heartbeat support
 	Heartbeat bool
+
+	// Allow for afrz transactions to target the zero address, freezing that
+	// asset for all holders. Subsequent unfreezing of an individuals holdings
+	// allows them to transfer the asset again.
+	EnableGlobalFreeze bool
 }
 
 // ProposerPayoutRules puts several related consensus parameters in one place. The same
@@ -1552,6 +1557,7 @@ func initConsensusProtocols() {
 	vFuture.ApprovedUpgrades = map[protocol.ConsensusVersion]uint64{}
 
 	vFuture.LogicSigVersion = 12 // When moving this to a release, put a new higher LogicSigVersion here
+	vFuture.EnableGlobalFreeze = true
 
 	Consensus[protocol.ConsensusFuture] = vFuture
 

daemon/algod/api/algod.oas2.json

@@ -3377,6 +3377,10 @@
           "description": "\\[f\\] Address of account used to freeze holdings of this asset.  If empty, freezing is not permitted.",
           "type": "string"
         },
+        "frozen": {
+          "description": "\\[fr\\] Whether this asset is frozen.",
+          "type": "boolean"
+        },
         "manager": {
           "description": "\\[m\\] Address of account used to manage the keys of this asset and to destroy it.",
           "type": "string"

daemon/algod/api/algod.oas3.yml

@@ -1613,6 +1613,10 @@
             "description": "\\[f\\] Address of account used to freeze holdings of this asset.  If empty, freezing is not permitted.",
             "type": "string"
           },
+          "frozen": {
+            "description": "\\[fr\\] Whether this asset is frozen.",
+            "type": "boolean"
+          },
           "manager": {
             "description": "\\[m\\] Address of account used to manage the keys of this asset and to destroy it.",
             "type": "string"

daemon/algod/api/server/v2/account.go

@@ -255,6 +255,12 @@ func AccountToAccountData(a *model.Account) (basics.AccountData, error) {
 			if ca.Params.DefaultFrozen != nil {
 				defaultFrozen = *ca.Params.DefaultFrozen
 			}
+			var lastGlobalFreeze uint64
+			if ca.Params.Frozen != nil {
+				// model.Asset doesn't know the LastGlobalFreeze value, so we
+				// fake it by setting it to MaxUint64 for basics.AssetParams.
+				lastGlobalFreeze = math.MaxUint64
+			}
 			var url string
 			if ca.Params.Url != nil {
 				url = *ca.Params.Url
@@ -269,17 +275,18 @@ func AccountToAccountData(a *model.Account) (basics.AccountData, error) {
 			}
 
 			assetParams[basics.AssetIndex(ca.Index)] = basics.AssetParams{
-				Total:         ca.Params.Total,
-				Decimals:      uint32(ca.Params.Decimals),
-				DefaultFrozen: defaultFrozen,
-				UnitName:      unitName,
-				AssetName:     name,
-				URL:           url,
-				MetadataHash:  metadataHash,
-				Manager:       manager,
-				Reserve:       reserve,
-				Freeze:        freeze,
-				Clawback:      clawback,
+				Total:            ca.Params.Total,
+				Decimals:         uint32(ca.Params.Decimals),
+				DefaultFrozen:    defaultFrozen,
+				LastGlobalFreeze: lastGlobalFreeze,
+				UnitName:         unitName,
+				AssetName:        name,
+				URL:              url,
+				MetadataHash:     metadataHash,
+				Manager:          manager,
+				Reserve:          reserve,
+				Freeze:           freeze,
+				Clawback:         clawback,
 			}
 		}
 	}
@@ -488,6 +495,7 @@ func AssetParamsToAsset(creator string, idx basics.AssetIndex, params *basics.As
 		Total:         params.Total,
 		Decimals:      uint64(params.Decimals),
 		DefaultFrozen: &frozen,
+		Frozen:        omitEmpty(uint64ToBool(params.LastGlobalFreeze)),
 		Name:          omitEmpty(printableUTF8OrEmpty(params.AssetName)),
 		NameB64:       sliceOrNil([]byte(params.AssetName)),
 		UnitName:      omitEmpty(printableUTF8OrEmpty(params.UnitName)),