forked from hyperledger/fabric-sdk-go
-
Notifications
You must be signed in to change notification settings - Fork 0
/
fabsdk.go
298 lines (247 loc) · 8.38 KB
/
fabsdk.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
/*
Copyright SecureKey Technologies Inc. All Rights Reserved.
SPDX-License-Identifier: Apache-2.0
*/
// Package fabsdk enables client usage of a Hyperledger Fabric network.
package fabsdk
import (
"math/rand"
"time"
contextApi "github.com/hyperledger/fabric-sdk-go/pkg/common/providers/context"
"github.com/hyperledger/fabric-sdk-go/pkg/context"
"github.com/hyperledger/fabric-sdk-go/pkg/core/logging/api"
"github.com/hyperledger/fabric-sdk-go/pkg/common/logging"
"github.com/hyperledger/fabric-sdk-go/pkg/common/providers/core"
"github.com/hyperledger/fabric-sdk-go/pkg/core/cryptosuite"
sdkApi "github.com/hyperledger/fabric-sdk-go/pkg/fabsdk/api"
"github.com/hyperledger/fabric-sdk-go/pkg/fabsdk/provider/chpvdr"
"github.com/pkg/errors"
)
var logger = logging.NewLogger("fabsdk")
// FabricSDK provides access (and context) to clients being managed by the SDK.
type FabricSDK struct {
opts options
provider *context.Provider
}
type options struct {
Core sdkApi.CoreProviderFactory
MSP sdkApi.MSPProviderFactory
Service sdkApi.ServiceProviderFactory
Logger api.LoggerProvider
}
// Option configures the SDK.
type Option func(opts *options) error
type closeable interface {
Close()
}
// New initializes the SDK based on the set of options provided.
// configProvider provides the application configuration.
func New(cp core.ConfigProvider, opts ...Option) (*FabricSDK, error) {
pkgSuite := defPkgSuite{}
config, err := cp()
if err != nil {
return nil, errors.WithMessage(err, "unable to load configuration")
}
return fromPkgSuite(config, &pkgSuite, opts...)
}
// WithConfig converts a Config interface to a ConfigProvider.
// This is a helper function for those who already loaded the config
// prior to instantiating the SDK.
func WithConfig(config core.Config) core.ConfigProvider {
return func() (core.Config, error) {
return config, nil
}
}
// fromPkgSuite creates an SDK based on the implementations in the provided pkg suite.
// TODO: For now leaving this method as private until we have more usage.
func fromPkgSuite(config core.Config, pkgSuite pkgSuite, opts ...Option) (*FabricSDK, error) {
core, err := pkgSuite.Core()
if err != nil {
return nil, errors.WithMessage(err, "Unable to initialize core pkg")
}
msp, err := pkgSuite.MSP()
if err != nil {
return nil, errors.WithMessage(err, "Unable to initialize core pkg")
}
svc, err := pkgSuite.Service()
if err != nil {
return nil, errors.WithMessage(err, "Unable to initialize service pkg")
}
lg, err := pkgSuite.Logger()
if err != nil {
return nil, errors.WithMessage(err, "Unable to initialize logger pkg")
}
sdk := FabricSDK{
opts: options{
Core: core,
MSP: msp,
Service: svc,
Logger: lg,
},
}
err = initSDK(&sdk, config, opts)
if err != nil {
return nil, err
}
return &sdk, err
}
// WithCorePkg injects the core implementation into the SDK.
func WithCorePkg(core sdkApi.CoreProviderFactory) Option {
return func(opts *options) error {
opts.Core = core
return nil
}
}
// WithMSPPkg injects the MSP implementation into the SDK.
func WithMSPPkg(msp sdkApi.MSPProviderFactory) Option {
return func(opts *options) error {
opts.MSP = msp
return nil
}
}
// WithServicePkg injects the service implementation into the SDK.
func WithServicePkg(service sdkApi.ServiceProviderFactory) Option {
return func(opts *options) error {
opts.Service = service
return nil
}
}
// WithLoggerPkg injects the logger implementation into the SDK.
func WithLoggerPkg(logger api.LoggerProvider) Option {
return func(opts *options) error {
opts.Logger = logger
return nil
}
}
// providerInit interface allows for initializing providers
// TODO: minimize interface
type providerInit interface {
Initialize(providers contextApi.Providers) error
}
func initSDK(sdk *FabricSDK, config core.Config, opts []Option) error {
for _, option := range opts {
err := option(&sdk.opts)
if err != nil {
return errors.WithMessage(err, "Error in option passed to New")
}
}
// Initialize logging provider with default logging provider (if needed)
if sdk.opts.Logger == nil {
return errors.New("Missing logger from pkg suite")
}
logging.Initialize(sdk.opts.Logger)
// Initialize crypto provider
cryptoSuite, err := sdk.opts.Core.CreateCryptoSuiteProvider(config)
if err != nil {
return errors.WithMessage(err, "failed to initialize crypto suite")
}
// Initialize rand (TODO: should probably be optional)
rand.Seed(time.Now().UnixNano())
// Setting this cryptosuite as the factory default
if !cryptosuite.DefaultInitialized() {
err = cryptosuite.SetDefault(cryptoSuite)
if err != nil {
return errors.WithMessage(err, "failed to set default crypto suite")
}
} else {
logger.Debug("default cryptosuite already initialized")
}
// Initialize state store
userStore, err := sdk.opts.MSP.CreateUserStore(config)
if err != nil {
return errors.WithMessage(err, "failed to create state store")
}
// Initialize Signing Manager
signingManager, err := sdk.opts.Core.CreateSigningManager(cryptoSuite, config)
if err != nil {
return errors.WithMessage(err, "failed to create signing manager")
}
// Initialize IdentityManagerProvider
identityManagerProvider, err := sdk.opts.MSP.CreateIdentityManagerProvider(config, cryptoSuite, userStore)
if err != nil {
return errors.WithMessage(err, "failed to create identity manager provider")
}
// Initialize Fabric provider
infraProvider, err := sdk.opts.Core.CreateInfraProvider(config)
if err != nil {
return errors.WithMessage(err, "failed to create infra provider")
}
// Initialize discovery provider
discoveryProvider, err := sdk.opts.Service.CreateDiscoveryProvider(config, infraProvider)
if err != nil {
return errors.WithMessage(err, "failed to create discovery provider")
}
// Initialize selection provider (for selecting endorsing peers)
selectionProvider, err := sdk.opts.Service.CreateSelectionProvider(config)
if err != nil {
return errors.WithMessage(err, "failed to create selection provider")
}
channelProvider, err := chpvdr.New(infraProvider)
if err != nil {
return errors.WithMessage(err, "failed to create channel provider")
}
//update sdk providers list since all required providers are initialized
sdk.provider = context.NewProvider(context.WithConfig(config),
context.WithCryptoSuite(cryptoSuite),
context.WithSigningManager(signingManager),
context.WithUserStore(userStore),
context.WithDiscoveryProvider(discoveryProvider),
context.WithSelectionProvider(selectionProvider),
context.WithIdentityManagerProvider(identityManagerProvider),
context.WithInfraProvider(infraProvider),
context.WithChannelProvider(channelProvider))
//initialize
if pi, ok := infraProvider.(providerInit); ok {
err = pi.Initialize(sdk.provider)
if err != nil {
return errors.WithMessage(err, "failed to initialize infra provider")
}
}
if pi, ok := discoveryProvider.(providerInit); ok {
err = pi.Initialize(sdk.provider)
if err != nil {
return errors.WithMessage(err, "failed to initialize discovery provider")
}
}
if pi, ok := selectionProvider.(providerInit); ok {
err = pi.Initialize(sdk.provider)
if err != nil {
return errors.WithMessage(err, "failed to initialize selection provider")
}
}
return nil
}
// Close frees up caches and connections being maintained by the SDK
func (sdk *FabricSDK) Close() {
if pvdr, ok := sdk.provider.DiscoveryProvider().(closeable); ok {
pvdr.Close()
}
if pvdr, ok := sdk.provider.SelectionProvider().(closeable); ok {
pvdr.Close()
}
sdk.provider.InfraProvider().Close()
}
// Config returns the SDK's configuration.
func (sdk *FabricSDK) Config() core.Config {
return sdk.provider.Config()
}
//Context creates and returns context client which has all the necessary providers
func (sdk *FabricSDK) Context(options ...ContextOption) contextApi.ClientProvider {
clientProvider := func() (contextApi.Client, error) {
identity, err := sdk.newIdentity(options...)
if err == ErrAnonymousIdentity {
identity = nil
err = nil
}
return &context.Client{Providers: sdk.provider, SigningIdentity: identity}, err
}
return clientProvider
}
//ChannelContext creates and returns channel context
func (sdk *FabricSDK) ChannelContext(channelID string, options ...ContextOption) contextApi.ChannelProvider {
channelProvider := func() (contextApi.Channel, error) {
clientCtxProvider := sdk.Context(options...)
return context.NewChannel(clientCtxProvider, channelID)
}
return channelProvider
}