tokens

Documentation

Index

• Constants
• type Callbacks
• type Capabilities
• type Plugin
• type TokenPool

Constants

const (
	// TokensConfigName is the user-supplied name for this token type
	TokensConfigName = "name"
	// TokensConfigConnector is the connector plugin used for this token type (deprecated)
	TokensConfigConnector = "connector" // TODO: remove
	// TokensConfigPlugin is the connector plugin used for this token type
	TokensConfigPlugin = "plugin"
)

Types

type Callbacks

type Callbacks interface {
	// TokensOpUpdate notifies firefly of an update to this plugin's operation within a transaction.
	// Only success/failure and errorMessage (for errors) are modeled.
	// opOutput can be used to add opaque protocol specific JSON from the plugin (protocol transaction ID etc.)
	// Note this is an optional hook information, and stored separately to the confirmation of the actual event that was being submitted/sequenced.
	// Only the party submitting the transaction will see this data.
	//
	// Error should will only be returned in shutdown scenarios
	TokenOpUpdate(plugin Plugin, operationID *fftypes.UUID, txState fftypes.OpStatus, errorMessage string, opOutput fftypes.JSONObject) error

	// TokenPoolCreated notifies on the creation of a new token pool, which might have been
	// submitted by us, or by any other authorized party in the network.
	//
	// Error should will only be returned in shutdown scenarios
	TokenPoolCreated(plugin Plugin, pool *TokenPool, protocolTxID string, additionalInfo fftypes.JSONObject) error

	// TokensTransferred notifies on a transfer between token accounts.
	//
	// Error should will only be returned in shutdown scenarios
	TokensTransferred(plugin Plugin, poolProtocolID string, transfer *fftypes.TokenTransfer, protocolTxID string, additionalInfo fftypes.JSONObject) error
}

Callbacks is the interface provided to the tokens plugin, to allow it to pass events back to firefly.

Events must be delivered sequentially, such that event 2 is not delivered until the callback invoked for event 1 has completed. However, it does not matter if these events are workload balance between the firefly core cluster instances of the node.

type Capabilities

type Capabilities struct {
}

Capabilities the supported featureset of the tokens interface implemented by the plugin, with the specified config

type Plugin

type Plugin interface {
	fftypes.Named

	// InitPrefix initializes the set of configuration options that are valid, with defaults. Called on all plugins.
	InitPrefix(prefix config.PrefixArray)

	// Init initializes the plugin, with configuration
	// Returns the supported featureset of the interface
	Init(ctx context.Context, name string, prefix config.Prefix, callbacks Callbacks) error

	// Blockchain interface must not deliver any events until start is called
	Start() error

	// Capabilities returns capabilities - not called until after Init
	Capabilities() *Capabilities

	// CreateTokenPool creates a new (fungible or non-fungible) pool of tokens
	CreateTokenPool(ctx context.Context, operationID *fftypes.UUID, pool *fftypes.TokenPool) error

	// ActivateTokenPool activates a pool in order to begin receiving events
	ActivateTokenPool(ctx context.Context, operationID *fftypes.UUID, pool *fftypes.TokenPool, tx *fftypes.Transaction) error

	// MintTokens mints new tokens in a pool and adds them to the recipient's account
	MintTokens(ctx context.Context, operationID *fftypes.UUID, poolProtocolID string, mint *fftypes.TokenTransfer) error

	// BurnTokens burns tokens from an account
	BurnTokens(ctx context.Context, operationID *fftypes.UUID, poolProtocolID string, burn *fftypes.TokenTransfer) error

	// TransferTokens transfers tokens within a pool from one account to another
	TransferTokens(ctx context.Context, operationID *fftypes.UUID, poolProtocolID string, transfer *fftypes.TokenTransfer) error
}

Plugin is the interface implemented by each tokens plugin

type TokenPool

type TokenPool struct {
	// Type is the type of tokens (fungible, non-fungible, etc) in this pool
	Type fftypes.TokenType

	// ProtocolID is the ID assigned to this pool by the connector (must be unique for this connector)
	ProtocolID string

	// TransactionID is the FireFly-assigned ID to correlate this to a transaction (optional)
	// Not guaranteed to be set for pool creation events triggered outside of FireFly
	TransactionID *fftypes.UUID

	// Key is the chain-specific identifier for the user that created the pool
	Key string

	// Connector is the configured name of this connector
	Connector string

	// Standard is the well-defined token standard that this pool conforms to (optional)
	Standard string
}

TokenPool is the set of data returned from the connector when a token pool is created.