package container import ( "errors" "fmt" "git.frostfs.info/TrueCloudLab/frostfs-node/pkg/morph/client" "github.com/nspcc-dev/neo-go/pkg/encoding/fixedn" "github.com/nspcc-dev/neo-go/pkg/util" ) // Client is a wrapper over StaticClient // which makes calls with the names and arguments // of the FrostFS Container contract. // // Working client must be created via constructor New. // Using the Client that has been created with new(Client) // expression (or just declaring a Client variable) is unsafe // and can lead to panic. type Client struct { client *client.StaticClient // static Container contract client } const ( putMethod = "put" deleteMethod = "delete" getMethod = "get" listMethod = "list" containersOfMethod = "containersOf" eaclMethod = "eACL" setEACLMethod = "setEACL" startEstimationMethod = "startContainerEstimation" stopEstimationMethod = "stopContainerEstimation" putSizeMethod = "putContainerSize" listSizesMethod = "listContainerSizes" getSizeMethod = "getContainerSize" // putNamedMethod is method name for container put with an alias. It is exported to provide custom fee. putNamedMethod = "putNamed" ) var ( errNilArgument = errors.New("empty argument") ) // NewFromMorph returns the wrapper instance from the raw morph client. // // Specified fee is used for all operations by default. If WithCustomFeeForNamedPut is provided, // the customized fee is used for Put operations with named containers. func NewFromMorph(cli *client.Client, contract util.Uint160, fee fixedn.Fixed8, opts ...Option) (*Client, error) { o := defaultOpts() for i := range opts { opts[i](o) } sc, err := client.NewStatic(cli, contract, fee, o.staticOpts...) if err != nil { return nil, fmt.Errorf("can't create container static client: %w", err) } return &Client{client: sc}, nil } // Morph returns raw morph client. func (c Client) Morph() *client.Client { return c.client.Morph() } // ContractAddress returns the address of the associated contract. func (c Client) ContractAddress() util.Uint160 { return c.client.ContractAddress() } // Option allows to set an optional // parameter of Wrapper. type Option func(*opts) type opts struct { staticOpts []client.StaticClientOption } func defaultOpts() *opts { return new(opts) } // TryNotary returns option to enable // notary invocation tries. func TryNotary() Option { return func(o *opts) { o.staticOpts = append(o.staticOpts, client.TryNotary()) } } // AsAlphabet returns option to sign main TX // of notary requests with client's private // key. // // Considered to be used by IR nodes only. func AsAlphabet() Option { return func(o *opts) { o.staticOpts = append(o.staticOpts, client.AsAlphabet()) } }