model

Documentation

Index

• func Scale(v, s0, s1 int64) int64
• func UndoScale(v float64, s int64) int64
• func UpdateBalances(operation string, fromTo map[string]Amount, balances []*mmodel.Balance, ...)
• func ValidateBalancesRules(ctx context.Context, transaction Transaction, validate Responses, ...) error
• func ValidateFromToOperation(ft FromTo, validate Responses, balance *mmodel.Balance) (Amount, Balance, error)
• type Amount
  • func FindScale(asset string, v float64, s int64) Amount
• type Balance
  • func OperateBalances(amount Amount, balance Balance, operation string) Balance
• type Distribute
• type FromTo
• type Metadata
• type Rate
  • func (r Rate) IsEmpty() bool
• type Responses
  • func ValidateSendSourceAndDistribute(transaction Transaction) (*Responses, error)
• type Send
• type Share
• type Source
• type Transaction
  • func (t Transaction) IsEmpty() bool

Functions

func Scale

func Scale(v, s0, s1 int64) int64

Scale func scale: (V * 10^ (S0-S1))

func UndoScale

func UndoScale(v float64, s int64) int64

UndoScale Function to undo the scale calculation

func UpdateBalances

func UpdateBalances(operation string, fromTo map[string]Amount, balances []*mmodel.Balance, result chan []*mmodel.Balance)

UpdateBalances function with some updates values in balances and

func ValidateBalancesRules

func ValidateBalancesRules(ctx context.Context, transaction Transaction, validate Responses, balances []*mmodel.Balance) error

ValidateBalancesRules function with some validates in accounts and DSL operations

func ValidateFromToOperation

func ValidateFromToOperation(ft FromTo, validate Responses, balance *mmodel.Balance) (Amount, Balance, error)

ValidateFromToOperation func that validate operate balance

Types

type Amount

type Amount struct {
	Asset string `json:"asset,omitempty" validate:"required" example:"BRL"`
	Value int64  `json:"value,omitempty" validate:"required" example:"1000"`
	Scale int64  `json:"scale,omitempty" validate:"gte=0" example:"2"`

} // @name Amount

Amount structure for marshaling/unmarshalling JSON.

swagger:model Amount @Description Amount is the struct designed to represent the amount of an operation.

func FindScale

func FindScale(asset string, v float64, s int64) Amount

FindScale Function to find the scale for any value of a value

type Balance

type Balance struct {
	Available int64 `json:"available" example:"1500"`
	OnHold    int64 `json:"onHold" example:"500"`
	Scale     int64 `json:"scale" example:"2"`

} // @name Balance

Balance structure for marshaling/unmarshalling JSON.

swagger:model Balance @Description Balance is the struct designed to represent the account balance.

func OperateBalances

func OperateBalances(amount Amount, balance Balance, operation string) Balance

OperateBalances Function to sum or sub two balances and normalize the scale

type Distribute

type Distribute struct {
	Remaining string   `json:"remaining,omitempty"`
	To        []FromTo `json:"to,omitempty" validate:"singletransactiontype,required,dive"`

} // @name Distribute

Distribute structure for marshaling/unmarshalling JSON.

swagger:model Distribute @Description Distribute is the struct designed to represent the distribution fields of an operation.

type FromTo

type FromTo struct {
	Account         string         `json:"account,omitempty" example:"@person1"`
	Amount          *Amount        `json:"amount,omitempty"`
	Share           *Share         `json:"share,omitempty"`
	Remaining       string         `json:"remaining,omitempty" example:"remaining"`
	Rate            *Rate          `json:"rate,omitempty"`
	Description     string         `json:"description,omitempty" example:"description"`
	ChartOfAccounts string         `json:"chartOfAccounts" example:"1000"`
	Metadata        map[string]any `json:"metadata" validate:"dive,keys,keymax=100,endkeys,nonested,valuemax=2000"`
	IsFrom          bool           `json:"isFrom,omitempty" example:"true"`

} // @name FromTo

FromTo structure for marshaling/unmarshalling JSON.

swagger:model FromTo @Description FromTo is the struct designed to represent the from/to fields of an operation.

type Metadata

type Metadata struct {
	Key   string `json:"key,omitempty"`
	Value any    `json:"value,omitempty"`

} // @name Metadata

Metadata structure for marshaling/unmarshalling JSON.

swagger:model Metadata @Description Metadata is the struct designed to store metadata.

type Rate

type Rate struct {
	From       string `json:"from" validate:"required" example:"BRL"`
	To         string `json:"to" validate:"required" example:"USDe"`
	Value      int64  `json:"value" validate:"required" example:"1000"`
	Scale      int64  `json:"scale" validate:"gte=0" example:"2"`
	ExternalID string `json:"externalId" validate:"uuid,required" example:"00000000-0000-0000-0000-000000000000"`

} // @name Rate

Rate structure for marshaling/unmarshalling JSON.

swagger:model Rate @Description Rate is the struct designed to represent the rate fields of an operation.

func (Rate) IsEmpty

func (r Rate) IsEmpty() bool

IsEmpty method that set empty or nil in fields

type Responses

type Responses struct {
	Total        int64
	Asset        string
	From         map[string]Amount
	To           map[string]Amount
	Sources      []string
	Destinations []string
	Aliases      []string
}

func ValidateSendSourceAndDistribute

func ValidateSendSourceAndDistribute(transaction Transaction) (*Responses, error)

ValidateSendSourceAndDistribute Validate send and distribute totals

type Send

type Send struct {
	Asset      string     `json:"asset,omitempty" validate:"required" example:"BRL"`
	Value      int64      `json:"value,omitempty" validate:"required" example:"1000"`
	Scale      int64      `json:"scale,omitempty" validate:"gte=0" example:"2"`
	Source     Source     `json:"source,omitempty" validate:"required"`
	Distribute Distribute `json:"distribute,omitempty" validate:"required"`

} // @name Send

Send structure for marshaling/unmarshalling JSON.

swagger:model Send @Description Send is the struct designed to represent the sending fields of an operation.

type Share

type Share struct {
	Percentage             int64 `json:"percentage,omitempty" validate:"required"`
	PercentageOfPercentage int64 `json:"percentageOfPercentage,omitempty"`

} // @name Share

Share structure for marshaling/unmarshalling JSON.

swagger:model Share @Description Share is the struct designed to represent the sharing fields of an operation.

type Source

type Source struct {
	Remaining string   `json:"remaining,omitempty" example:"remaining"`
	From      []FromTo `json:"from,omitempty" validate:"singletransactiontype,required,dive"`

} // @name Source

Source structure for marshaling/unmarshalling JSON.

swagger:model Source @Description Source is the struct designed to represent the source fields of an operation.

type Transaction

type Transaction struct {
	ChartOfAccountsGroupName string         `json:"chartOfAccountsGroupName,omitempty" example:"1000"`
	Description              string         `json:"description,omitempty" example:"Description"`
	Code                     string         `json:"code,omitempty" example:"00000000-0000-0000-0000-000000000000"`
	Pending                  bool           `json:"pending,omitempty" example:"false"`
	Metadata                 map[string]any `json:"metadata,omitempty" validate:"dive,keys,keymax=100,endkeys,nonested,valuemax=2000"`
	Send                     Send           `json:"send" validate:"required"`

} // @name Transaction

Transaction structure for marshaling/unmarshalling JSON.

swagger:model Transaction @Description Transaction is a struct designed to store transaction data.

func (Transaction) IsEmpty

func (t Transaction) IsEmpty() bool

IsEmpty is a func that validate if transaction is Empty.