github.com/mavryk-network/mvgo@v1.19.9/contract/token.go

// Copyright (c) 2020-2022 Blockwatch Data Inc.
// Author: alex@blockwatch.cc

package contract

import (
	"context"
	"encoding/json"
	"fmt"
	"strconv"
	"time"

	"github.com/mavryk-network/mvgo/mavryk"
	"github.com/mavryk-network/mvgo/micheline"
)

type TokenKind byte

const (
	TokenKindInvalid TokenKind = iota
	TokenKindTez
	TokenKindFA1
	TokenKindFA1_2
	TokenKindFA2
	TokenKindNFT
	TokenKindNoView
)

func (k TokenKind) String() string {
	switch k {
	case TokenKindTez:
		return "tez"
	case TokenKindFA1:
		return "fa1"
	case TokenKindFA1_2:
		return "fa1_2"
	case TokenKindFA2:
		return "fa2"
	case TokenKindNFT:
		return "nft"
	case TokenKindNoView:
		return "noview"
	default:
		return ""
	}
}

func (k TokenKind) IsValid() bool {
	return k != TokenKindInvalid
}

const TOKEN_METADATA = "token_metadata"

// Represents Tzip12 token metadata used by FA1 and FA2 tokens
// mixed with TZip21 metadata for NFTs
type TokenMetadata struct {
	// TZip12 normative (only decimals is required)
	Name     string `json:"name"`
	Symbol   string `json:"symbol"`
	Decimals int    `json:"decimals"`

	// Tzip21
	Description        string          `json:"description,omitempty"`
	ShouldPreferSymbol bool            `json:"shouldPreferSymbol,omitempty"`
	IsBooleanAmount    bool            `json:"isBooleanAmount,omitempty"`
	IsTransferable     bool            `json:"isTransferable,omitempty"`
	ArtifactUri        string          `json:"artifactUri,omitempty"`
	DisplayUri         string          `json:"displayUri,omitempty"`
	ThumbnailUri       string          `json:"thumbnailUri,omitempty"`
	Minter             string          `json:"minter,omitempty"`
	Creators           []string        `json:"creators,omitempty"`
	Contributors       []string        `json:"contributors,omitempty"`
	Publishers         []string        `json:"publishers,omitempty"`
	Date               time.Time       `json:"date,omitempty"`
	Type               string          `json:"type,omitempty"`
	Tags               []string        `json:"tags,omitempty"`
	Genres             []string        `json:"genres,omitempty"`
	Language           string          `json:"language,omitempty"`
	Identifier         string          `json:"identifier,omitempty"`
	Rights             string          `json:"rights,omitempty"`
	RightUri           string          `json:"rightUri,omitempty"`
	ExternalUri        string          `json:"externalUri,omitempty"`
	Formats            []Tz21Format    `json:"formats,omitempty"`
	Attributes         []Tz21Attribute `json:"attributes,omitempty"`

	// internal
	uri string          `json:"-"`
	raw json.RawMessage `json:"-"`
}

type Tz21Format struct {
	Uri        string        `json:"uri"`
	Hash       string        `json:"hash"`
	MimeType   string        `json:"mimeType"`
	FileSize   int64         `json:"fileSize"`
	FileName   string        `json:"fileName"`
	Duration   string        `json:"duration"`
	Dimensions Tz21Dimension `json:"dimensions"`
	DataRate   Tz21DataRate  `json:"dataRate"`
}

type Tz21Attribute struct {
	Name  string `json:"name"`
	Value string `json:"value"`
	Type  string `json:"type,omitempty"`
}

type Tz21Dimension struct {
	Value string `json:"value"`
	Unit  string `json:"unit"`
}

type Tz21DataRate struct {
	Value string `json:"value"`
	Unit  string `json:"unit"`
}

// (pair (nat %token_id) (map %token_info string bytes))
func (t *TokenMetadata) UnmarshalPrim(prim micheline.Prim) error {
	if len(prim.Args) < 2 {
		return fmt.Errorf("invalid metadata prim %s", prim.Dump())
	}
	t.IsTransferable = true // default
	err := prim.Args[1].Walk(func(p micheline.Prim) error {
		if p.IsSequence() {
			return nil
		}
		if !p.IsElt() {
			return fmt.Errorf("unexpected map item %q", p.Dump())
		}
		field := p.Args[0].String
		data := p.Args[1].Bytes
		// unpack packed bytes (some people do that, yes)
		if p.Args[1].IsPacked() {
			p, _ := p.Args[1].Unpack()
			if p.Type == micheline.PrimBytes {
				data = p.Bytes
			} else {
				data = []byte(p.String)
			}
		}
		switch field {
		case "":
			t.uri = string(data)
		case "name":
			t.Name = string(data)
		case "description":
			t.Description = string(data)
		case "symbol":
			t.Symbol = string(data)
		case "icon", "logo", "thumbnailUri", "thumbnail_uri":
			t.ThumbnailUri = string(data)
		case "artifactUri", "artifact_uri":
			t.ArtifactUri = string(data)
		case "displayUri", "display_uri":
			t.DisplayUri = string(data)
		case "decimals":
			d, err := strconv.Atoi(string(data))
			if err != nil {
				return fmt.Errorf("%q: %v", field, err)
			}
			t.Decimals = d
		case "shouldPreferSymbol", "should_prefer_symbol":
			b, err := strconv.ParseBool(string(data))
			if err != nil {
				return fmt.Errorf("%q: %v", field, err)
			}
			t.ShouldPreferSymbol = b
		case "isBooleanAmount", "is_boolean_amount":
			b, err := strconv.ParseBool(string(data))
			if err != nil {
				return fmt.Errorf("%q: %v", field, err)
			}
			t.IsBooleanAmount = b
		case "isTransferable", "is_transferable":
			b, err := strconv.ParseBool(string(data))
			if err != nil {
				return fmt.Errorf("%q: %v", field, err)
			}
			t.IsTransferable = b
		case "nonTransferable": // non-standard
			b, err := strconv.ParseBool(string(data))
			if err != nil {
				return fmt.Errorf("%q: %v", field, err)
			}
			t.IsTransferable = !b
		default:
			log.Errorf("token metadata: unsupported field %q\n", field)
		}
		return micheline.PrimSkip
	})
	return err
}

func (t *TokenMetadata) UnmarshalJSON(data []byte) error {
	type Alias *TokenMetadata
	err := json.Unmarshal(data, Alias(t))
	if err != nil {
		return err
	}
	t.raw = json.RawMessage(data)
	return nil
}

func (t TokenMetadata) URI() string {
	return t.uri
}

func (t TokenMetadata) Raw() []byte {
	if t.raw != nil {
		return t.raw
	}
	buf, _ := json.Marshal(t)
	return buf
}

func ResolveTokenMetadata(ctx context.Context, contract *Contract, tokenid mavryk.Z) (*TokenMetadata, error) {
	var (
		store micheline.Prim
		err   error
	)

	// we need contract script and storage
	if err = contract.Resolve(ctx); err != nil {
		return nil, err
	}

	// lookup well known (pre-tz16 or wrong) tokens
	if m, ok := wellKnown[contract.Address().String()]; ok {
		return m, nil
	}

	// prefer off-chain view via run_code, but don't fail if not present
	tz16, _ := contract.ResolveMetadata(ctx)
	if tz16 != nil && tz16.HasView(TOKEN_METADATA) {
		view := tz16.GetView(TOKEN_METADATA)
		args := micheline.NewNat(tokenid.Big())
		store, err = view.Run(ctx, contract, args)
		if err != nil {
			return nil, err
		}
	} else {
		// read token_metadata bigmap
		bigmaps := contract.script.Bigmaps()
		id, ok := bigmaps[TOKEN_METADATA]
		if !ok {
			return nil, fmt.Errorf("%s/%d: missing token metadata, have %v", contract.addr, tokenid.Int64(), bigmaps)
		}
		hash := (micheline.Key{
			Type:   micheline.NewType(micheline.NewPrim(micheline.T_NAT)),
			IntKey: tokenid.Big(),
		}).Hash()
		store, err = contract.rpc.GetActiveBigmapValue(ctx, id, hash)
		if err != nil {
			return nil, err
		}
	}

	// parse storage: (pair (nat %token_id) (map %token_info string bytes))
	meta := &TokenMetadata{}
	if err := meta.UnmarshalPrim(store); err != nil {
		return nil, err
	}

	// should forward?
	if meta.uri != "" {
		if err := contract.ResolveTz16Uri(ctx, meta.uri, meta, nil); err != nil {
			return nil, err
		}
	}

	// fill empty token name from contract metadata
	if meta.Name == "" && tz16 != nil {
		meta.Name = tz16.Name
	}

	return meta, nil
}

type TokenBalance struct {
	Owner   mavryk.Address
	Token   mavryk.Address
	TokenId mavryk.Z
	Balance mavryk.Z
}