github.com/renegr87/renegr87@v2.1.1+incompatible/core/common/ccprovider/cdspackage.go (about)

     1  /*
     2  Copyright IBM Corp. 2017 All Rights Reserved.
     3  
     4  Licensed under the Apache License, Version 2.0 (the "License");
     5  you may not use this file except in compliance with the License.
     6  You may obtain a copy of the License at
     7  
     8  		 http://www.apache.org/licenses/LICENSE-2.0
     9  
    10  Unless required by applicable law or agreed to in writing, software
    11  distributed under the License is distributed on an "AS IS" BASIS,
    12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  See the License for the specific language governing permissions and
    14  limitations under the License.
    15  */
    16  
    17  package ccprovider
    18  
    19  import (
    20  	"bytes"
    21  	"fmt"
    22  	"hash"
    23  	"io/ioutil"
    24  	"os"
    25  
    26  	"github.com/golang/protobuf/proto"
    27  	pb "github.com/hyperledger/fabric-protos-go/peer"
    28  	"github.com/hyperledger/fabric/bccsp"
    29  )
    30  
    31  //----- CDSData ------
    32  
    33  //CDSData is data stored in the LSCC on instantiation of a CC
    34  //for CDSPackage.  This needs to be serialized for ChaincodeData
    35  //hence the protobuf format
    36  type CDSData struct {
    37  	//CodeHash hash of CodePackage from ChaincodeDeploymentSpec
    38  	CodeHash []byte `protobuf:"bytes,1,opt,name=codehash,proto3"`
    39  
    40  	//MetaDataHash hash of Name and Version from ChaincodeDeploymentSpec
    41  	MetaDataHash []byte `protobuf:"bytes,2,opt,name=metadatahash,proto3"`
    42  }
    43  
    44  //----implement functions needed from proto.Message for proto's mar/unmarshal functions
    45  
    46  //Reset resets
    47  func (data *CDSData) Reset() { *data = CDSData{} }
    48  
    49  //String converts to string
    50  func (data *CDSData) String() string { return proto.CompactTextString(data) }
    51  
    52  //ProtoMessage just exists to make proto happy
    53  func (*CDSData) ProtoMessage() {}
    54  
    55  //Equals data equals other
    56  func (data *CDSData) Equals(other *CDSData) bool {
    57  	return other != nil && bytes.Equal(data.CodeHash, other.CodeHash) && bytes.Equal(data.MetaDataHash, other.MetaDataHash)
    58  }
    59  
    60  // GetHasher interface defines a subset of bccsp which contains GetHash function.
    61  type GetHasher interface {
    62  	GetHash(opts bccsp.HashOpts) (h hash.Hash, err error)
    63  }
    64  
    65  //--------- CDSPackage ------------
    66  
    67  //CDSPackage encapsulates ChaincodeDeploymentSpec.
    68  type CDSPackage struct {
    69  	buf       []byte
    70  	depSpec   *pb.ChaincodeDeploymentSpec
    71  	data      *CDSData
    72  	datab     []byte
    73  	id        []byte
    74  	GetHasher GetHasher
    75  }
    76  
    77  // GetId gets the fingerprint of the chaincode based on package computation
    78  func (ccpack *CDSPackage) GetId() []byte {
    79  	//this has to be after creating a package and initializing it
    80  	//If those steps fail, GetId() should never be called
    81  	if ccpack.id == nil {
    82  		panic("GetId called on uninitialized package")
    83  	}
    84  	return ccpack.id
    85  }
    86  
    87  // GetDepSpec gets the ChaincodeDeploymentSpec from the package
    88  func (ccpack *CDSPackage) GetDepSpec() *pb.ChaincodeDeploymentSpec {
    89  	//this has to be after creating a package and initializing it
    90  	//If those steps fail, GetDepSpec() should never be called
    91  	if ccpack.depSpec == nil {
    92  		panic("GetDepSpec called on uninitialized package")
    93  	}
    94  	return ccpack.depSpec
    95  }
    96  
    97  // GetDepSpecBytes gets the serialized ChaincodeDeploymentSpec from the package
    98  func (ccpack *CDSPackage) GetDepSpecBytes() []byte {
    99  	//this has to be after creating a package and initializing it
   100  	//If those steps fail, GetDepSpecBytes() should never be called
   101  	if ccpack.buf == nil {
   102  		panic("GetDepSpecBytes called on uninitialized package")
   103  	}
   104  	return ccpack.buf
   105  }
   106  
   107  // GetPackageObject gets the ChaincodeDeploymentSpec as proto.Message
   108  func (ccpack *CDSPackage) GetPackageObject() proto.Message {
   109  	return ccpack.depSpec
   110  }
   111  
   112  // GetChaincodeData gets the ChaincodeData
   113  func (ccpack *CDSPackage) GetChaincodeData() *ChaincodeData {
   114  	//this has to be after creating a package and initializing it
   115  	//If those steps fail, GetChaincodeData() should never be called
   116  	if ccpack.depSpec == nil || ccpack.datab == nil || ccpack.id == nil {
   117  		panic("GetChaincodeData called on uninitialized package")
   118  	}
   119  	return &ChaincodeData{Name: ccpack.depSpec.ChaincodeSpec.ChaincodeId.Name, Version: ccpack.depSpec.ChaincodeSpec.ChaincodeId.Version, Data: ccpack.datab, Id: ccpack.id}
   120  }
   121  
   122  func (ccpack *CDSPackage) getCDSData(cds *pb.ChaincodeDeploymentSpec) ([]byte, []byte, *CDSData, error) {
   123  	// check for nil argument. It is an assertion that getCDSData
   124  	// is never called on a package that did not go through/succeed
   125  	// package initialization.
   126  	if cds == nil {
   127  		panic("nil cds")
   128  	}
   129  
   130  	b, err := proto.Marshal(cds)
   131  	if err != nil {
   132  		return nil, nil, nil, err
   133  	}
   134  
   135  	//compute hashes now
   136  	// hash, err := factory.GetDefault().GetHash(&bccsp.SHAOpts{})
   137  	hash, err := ccpack.GetHasher.GetHash(&bccsp.SHAOpts{})
   138  	if err != nil {
   139  		return nil, nil, nil, err
   140  	}
   141  
   142  	cdsdata := &CDSData{}
   143  
   144  	//code hash
   145  	hash.Write(cds.CodePackage)
   146  	cdsdata.CodeHash = hash.Sum(nil)
   147  
   148  	hash.Reset()
   149  
   150  	//metadata hash
   151  	hash.Write([]byte(cds.ChaincodeSpec.ChaincodeId.Name))
   152  	hash.Write([]byte(cds.ChaincodeSpec.ChaincodeId.Version))
   153  
   154  	cdsdata.MetaDataHash = hash.Sum(nil)
   155  
   156  	b, err = proto.Marshal(cdsdata)
   157  	if err != nil {
   158  		return nil, nil, nil, err
   159  	}
   160  
   161  	hash.Reset()
   162  
   163  	//compute the id
   164  	hash.Write(cdsdata.CodeHash)
   165  	hash.Write(cdsdata.MetaDataHash)
   166  
   167  	id := hash.Sum(nil)
   168  
   169  	return b, id, cdsdata, nil
   170  }
   171  
   172  // ValidateCC returns error if the chaincode is not found or if its not a
   173  // ChaincodeDeploymentSpec
   174  func (ccpack *CDSPackage) ValidateCC(ccdata *ChaincodeData) error {
   175  	if ccpack.depSpec == nil {
   176  		return fmt.Errorf("uninitialized package")
   177  	}
   178  
   179  	if ccpack.data == nil {
   180  		return fmt.Errorf("nil data")
   181  	}
   182  
   183  	// This is a hack. LSCC expects a specific LSCC error when names are invalid so it
   184  	// has its own validation code. We can't use that error because of import cycles.
   185  	// Unfortunately, we also need to check if what have makes some sort of sense as
   186  	// protobuf will gladly deserialize garbage and there are paths where we assume that
   187  	// a successful unmarshal means everything works but, if it fails, we try to unmarshal
   188  	// into something different.
   189  	if !isPrintable(ccdata.Name) {
   190  		return fmt.Errorf("invalid chaincode name: %q", ccdata.Name)
   191  	}
   192  
   193  	if ccdata.Name != ccpack.depSpec.ChaincodeSpec.ChaincodeId.Name || ccdata.Version != ccpack.depSpec.ChaincodeSpec.ChaincodeId.Version {
   194  		return fmt.Errorf("invalid chaincode data %v (%v)", ccdata, ccpack.depSpec.ChaincodeSpec.ChaincodeId)
   195  	}
   196  
   197  	otherdata := &CDSData{}
   198  	err := proto.Unmarshal(ccdata.Data, otherdata)
   199  	if err != nil {
   200  		return err
   201  	}
   202  
   203  	if !ccpack.data.Equals(otherdata) {
   204  		return fmt.Errorf("data mismatch")
   205  	}
   206  
   207  	return nil
   208  }
   209  
   210  //InitFromBuffer sets the buffer if valid and returns ChaincodeData
   211  func (ccpack *CDSPackage) InitFromBuffer(buf []byte) (*ChaincodeData, error) {
   212  
   213  	depSpec := &pb.ChaincodeDeploymentSpec{}
   214  	err := proto.Unmarshal(buf, depSpec)
   215  	if err != nil {
   216  		return nil, fmt.Errorf("failed to unmarshal deployment spec from bytes")
   217  	}
   218  
   219  	databytes, id, data, err := ccpack.getCDSData(depSpec)
   220  	if err != nil {
   221  		return nil, err
   222  	}
   223  
   224  	ccpack.buf = buf
   225  	ccpack.depSpec = depSpec
   226  	ccpack.data = data
   227  	ccpack.datab = databytes
   228  	ccpack.id = id
   229  
   230  	return ccpack.GetChaincodeData(), nil
   231  }
   232  
   233  //InitFromFS returns the chaincode and its package from the file system
   234  func (ccpack *CDSPackage) InitFromPath(ccNameVersion string, path string) ([]byte, *pb.ChaincodeDeploymentSpec, error) {
   235  
   236  	buf, err := GetChaincodePackageFromPath(ccNameVersion, path)
   237  	if err != nil {
   238  		return nil, nil, err
   239  	}
   240  
   241  	ccdata, err := ccpack.InitFromBuffer(buf)
   242  	if err != nil {
   243  		return nil, nil, err
   244  	}
   245  
   246  	if err := ccpack.ValidateCC(ccdata); err != nil {
   247  		return nil, nil, err
   248  	}
   249  
   250  	return ccpack.buf, ccpack.depSpec, nil
   251  }
   252  
   253  //InitFromFS returns the chaincode and its package from the file system
   254  func (ccpack *CDSPackage) InitFromFS(ccNameVersion string) ([]byte, *pb.ChaincodeDeploymentSpec, error) {
   255  	return ccpack.InitFromPath(ccNameVersion, chaincodeInstallPath)
   256  }
   257  
   258  //PutChaincodeToFS - serializes chaincode to a package on the file system
   259  func (ccpack *CDSPackage) PutChaincodeToFS() error {
   260  	if ccpack.buf == nil {
   261  		return fmt.Errorf("uninitialized package")
   262  	}
   263  
   264  	if ccpack.id == nil {
   265  		return fmt.Errorf("id cannot be nil if buf is not nil")
   266  	}
   267  
   268  	if ccpack.depSpec == nil {
   269  		return fmt.Errorf("depspec cannot be nil if buf is not nil")
   270  	}
   271  
   272  	if ccpack.data == nil {
   273  		return fmt.Errorf("nil data")
   274  	}
   275  
   276  	if ccpack.datab == nil {
   277  		return fmt.Errorf("nil data bytes")
   278  	}
   279  
   280  	ccname := ccpack.depSpec.ChaincodeSpec.ChaincodeId.Name
   281  	ccversion := ccpack.depSpec.ChaincodeSpec.ChaincodeId.Version
   282  
   283  	//return error if chaincode exists
   284  	path := fmt.Sprintf("%s/%s.%s", chaincodeInstallPath, ccname, ccversion)
   285  	if _, err := os.Stat(path); err == nil {
   286  		return fmt.Errorf("chaincode %s exists", path)
   287  	}
   288  
   289  	if err := ioutil.WriteFile(path, ccpack.buf, 0644); err != nil {
   290  		return err
   291  	}
   292  
   293  	return nil
   294  }