Documentation ¶
Overview ¶
Code generated by counterfeiter. DO NOT EDIT.
Code generated by counterfeiter. DO NOT EDIT.
Code generated by counterfeiter. DO NOT EDIT.
Code generated by counterfeiter. DO NOT EDIT.
Package resmgmt enables creation and update of resources on a Fabric network. It allows administrators to create and/or update channnels, and for peers to join channels. Administrators can also perform chaincode related operations on a peer, such as installing, instantiating, and upgrading chaincode.
Basic Flow: 1) Prepare client context 2) Create resource managememt client 3) Create new channel 4) Peer(s) join channel 5) Install chaincode onto peer(s) filesystem 6) Instantiate chaincode on channel 7) Query peer for channels, installed/instantiated chaincodes etc.
Example ¶
// Create new resource management client c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } // Read channel configuration tx channelConfigTxPath := filepath.Join(metadata.GetProjectPath(), metadata.ChannelConfigPath, channelConfigTxFile) r, err := os.Open(channelConfigTxPath) if err != nil { fmt.Printf("failed to open channel config: %s\n", err) } defer r.Close() // Create new channel 'mychannel' _, err = c.SaveChannel(SaveChannelRequest{ChannelID: "mychannel", ChannelConfig: r}) if err != nil { fmt.Printf("failed to save channel: %s\n", err) } peer := mockPeer() // Peer joins channel 'mychannel' err = c.JoinChannel("mychannel", WithTargets(peer)) if err != nil { fmt.Printf("failed to join channel: %s\n", err) } // Install example chaincode to peer installReq := InstallCCRequest{Name: "ExampleCC", Version: "v0", Path: "path", Package: &resource.CCPackage{Type: 1, Code: []byte("bytes")}} _, err = c.InstallCC(installReq, WithTargets(peer)) if err != nil { fmt.Printf("failed to install chaincode: %s\n", err) } // Instantiate example chaincode on channel 'mychannel' ccPolicy := policydsl.SignedByMspMember("Org1MSP") instantiateReq := InstantiateCCRequest{Name: "ExampleCC", Version: "v0", Path: "path", Policy: ccPolicy} _, err = c.InstantiateCC("mychannel", instantiateReq, WithTargets(peer)) if err != nil { fmt.Printf("failed to install chaincode: %s\n", err) } fmt.Println("Network setup completed")
Output: Network setup completed
Index ¶
- Constants
- func CalculateConfigUpdate(channelID string, currentConfig, newConfig *common.Config) (*common.ConfigUpdate, error)
- func MarshalConfigSignature(signature *common.ConfigSignature) ([]byte, error)
- func UnmarshalConfigSignature(reader io.Reader) (*common.ConfigSignature, error)
- type CCReference
- type Client
- func (rc *Client) CreateConfigSignature(signer msp.SigningIdentity, channelConfigPath string) (*common.ConfigSignature, error)
- func (rc *Client) CreateConfigSignatureData(signer msp.SigningIdentity, channelConfigPath string) (signatureHeaderData resource.ConfigSignatureData, e error)
- func (rc *Client) CreateConfigSignatureDataFromReader(signer msp.SigningIdentity, channelConfig io.Reader) (signatureHeaderData resource.ConfigSignatureData, e error)
- func (rc *Client) CreateConfigSignatureFromReader(signer msp.SigningIdentity, channelConfig io.Reader) (*common.ConfigSignature, error)
- func (rc *Client) InstallCC(req InstallCCRequest, options ...RequestOption) ([]InstallCCResponse, error)
- func (rc *Client) InstantiateCC(channelID string, req InstantiateCCRequest, options ...RequestOption) (InstantiateCCResponse, error)
- func (rc *Client) JoinChannel(channelID string, options ...RequestOption) error
- func (rc *Client) LifecycleApproveCC(channelID string, req LifecycleApproveCCRequest, options ...RequestOption) (fab.TransactionID, error)
- func (rc *Client) LifecycleCheckCCCommitReadiness(channelID string, req LifecycleCheckCCCommitReadinessRequest, ...) (LifecycleCheckCCCommitReadinessResponse, error)
- func (rc *Client) LifecycleCommitCC(channelID string, req LifecycleCommitCCRequest, options ...RequestOption) (fab.TransactionID, error)
- func (rc *Client) LifecycleGetInstalledCCPackage(packageID string, options ...RequestOption) ([]byte, error)
- func (rc *Client) LifecycleInstallCC(req LifecycleInstallCCRequest, options ...RequestOption) ([]LifecycleInstallCCResponse, error)
- func (rc *Client) LifecycleQueryApprovedCC(channelID string, req LifecycleQueryApprovedCCRequest, ...) (LifecycleApprovedChaincodeDefinition, error)
- func (rc *Client) LifecycleQueryCommittedCC(channelID string, req LifecycleQueryCommittedCCRequest, ...) ([]LifecycleChaincodeDefinition, error)
- func (rc *Client) LifecycleQueryInstalledCC(options ...RequestOption) ([]LifecycleInstalledCC, error)
- func (rc *Client) QueryChannels(options ...RequestOption) (*pb.ChannelQueryResponse, error)
- func (rc *Client) QueryCollectionsConfig(channelID string, chaincodeName string, options ...RequestOption) (*pb.CollectionConfigPackage, error)
- func (rc *Client) QueryConfigBlockFromOrderer(channelID string, options ...RequestOption) (*common.Block, error)
- func (rc *Client) QueryConfigFromOrderer(channelID string, options ...RequestOption) (fab.ChannelCfg, error)
- func (rc *Client) QueryInstalledChaincodes(options ...RequestOption) (*pb.ChaincodeQueryResponse, error)
- func (rc *Client) QueryInstantiatedChaincodes(channelID string, options ...RequestOption) (*pb.ChaincodeQueryResponse, error)
- func (rc *Client) SaveChannel(req SaveChannelRequest, options ...RequestOption) (SaveChannelResponse, error)
- func (rc *Client) UpgradeCC(channelID string, req UpgradeCCRequest, options ...RequestOption) (UpgradeCCResponse, error)
- type ClientOption
- type InstallCCRequest
- type InstallCCResponse
- type InstantiateCCRequest
- type InstantiateCCResponse
- type LifecycleApproveCCRequest
- type LifecycleApprovedChaincodeDefinition
- type LifecycleChaincodeDefinition
- type LifecycleCheckCCCommitReadinessRequest
- type LifecycleCheckCCCommitReadinessResponse
- type LifecycleCommitCCRequest
- type LifecycleInstallCCRequest
- type LifecycleInstallCCResponse
- type LifecycleInstalledCC
- type LifecycleQueryApprovedCCRequest
- type LifecycleQueryCommittedCCRequest
- type MockChannelProvider
- func (fake *MockChannelProvider) ChannelService(ctx fab.ClientContext, channelID string) (fab.ChannelService, error)
- func (fake *MockChannelProvider) ChannelServiceArgsForCall(i int) (fab.ClientContext, string)
- func (fake *MockChannelProvider) ChannelServiceCallCount() int
- func (fake *MockChannelProvider) ChannelServiceReturns(result1 fab.ChannelService, result2 error)
- func (fake *MockChannelProvider) ChannelServiceReturnsOnCall(i int, result1 fab.ChannelService, result2 error)
- func (fake *MockChannelProvider) Invocations() map[string][][]interface{}
- type MockChannelService
- func (fake *MockChannelService) ChannelConfig() (fab.ChannelCfg, error)
- func (fake *MockChannelService) ChannelConfigCallCount() int
- func (fake *MockChannelService) ChannelConfigReturns(result1 fab.ChannelCfg, result2 error)
- func (fake *MockChannelService) ChannelConfigReturnsOnCall(i int, result1 fab.ChannelCfg, result2 error)
- func (fake *MockChannelService) Config() (fab.ChannelConfig, error)
- func (fake *MockChannelService) ConfigCallCount() int
- func (fake *MockChannelService) ConfigReturns(result1 fab.ChannelConfig, result2 error)
- func (fake *MockChannelService) ConfigReturnsOnCall(i int, result1 fab.ChannelConfig, result2 error)
- func (fake *MockChannelService) Discovery() (fab.DiscoveryService, error)
- func (fake *MockChannelService) DiscoveryCallCount() int
- func (fake *MockChannelService) DiscoveryReturns(result1 fab.DiscoveryService, result2 error)
- func (fake *MockChannelService) DiscoveryReturnsOnCall(i int, result1 fab.DiscoveryService, result2 error)
- func (fake *MockChannelService) EventService(opts ...options.Opt) (fab.EventService, error)
- func (fake *MockChannelService) EventServiceArgsForCall(i int) []options.Opt
- func (fake *MockChannelService) EventServiceCallCount() int
- func (fake *MockChannelService) EventServiceReturns(result1 fab.EventService, result2 error)
- func (fake *MockChannelService) EventServiceReturnsOnCall(i int, result1 fab.EventService, result2 error)
- func (fake *MockChannelService) Invocations() map[string][][]interface{}
- func (fake *MockChannelService) Membership() (fab.ChannelMembership, error)
- func (fake *MockChannelService) MembershipCallCount() int
- func (fake *MockChannelService) MembershipReturns(result1 fab.ChannelMembership, result2 error)
- func (fake *MockChannelService) MembershipReturnsOnCall(i int, result1 fab.ChannelMembership, result2 error)
- func (fake *MockChannelService) Selection() (fab.SelectionService, error)
- func (fake *MockChannelService) SelectionCallCount() int
- func (fake *MockChannelService) SelectionReturns(result1 fab.SelectionService, result2 error)
- func (fake *MockChannelService) SelectionReturnsOnCall(i int, result1 fab.SelectionService, result2 error)
- func (fake *MockChannelService) Transactor(reqCtx reqContext.Context) (fab.Transactor, error)
- func (fake *MockChannelService) TransactorArgsForCall(i int) reqContext.Context
- func (fake *MockChannelService) TransactorCallCount() int
- func (fake *MockChannelService) TransactorReturns(result1 fab.Transactor, result2 error)
- func (fake *MockChannelService) TransactorReturnsOnCall(i int, result1 fab.Transactor, result2 error)
- type MockLifecycleResource
- func (fake *MockLifecycleResource) CreateApproveProposal(txh fab.TransactionHeader, req *resource.ApproveChaincodeRequest) (*fab.TransactionProposal, error)
- func (fake *MockLifecycleResource) CreateApproveProposalArgsForCall(i int) (fab.TransactionHeader, *resource.ApproveChaincodeRequest)
- func (fake *MockLifecycleResource) CreateApproveProposalCallCount() int
- func (fake *MockLifecycleResource) CreateApproveProposalReturns(result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateApproveProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposal(txh fab.TransactionHeader, req *resource.CheckChaincodeCommitReadinessRequest) (*fab.TransactionProposal, error)
- func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalArgsForCall(i int) (fab.TransactionHeader, *resource.CheckChaincodeCommitReadinessRequest)
- func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalCallCount() int
- func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalReturns(result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateCommitProposal(txh fab.TransactionHeader, req *resource.CommitChaincodeRequest) (*fab.TransactionProposal, error)
- func (fake *MockLifecycleResource) CreateCommitProposalArgsForCall(i int) (fab.TransactionHeader, *resource.CommitChaincodeRequest)
- func (fake *MockLifecycleResource) CreateCommitProposalCallCount() int
- func (fake *MockLifecycleResource) CreateCommitProposalReturns(result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateCommitProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateQueryCommittedProposal(txh fab.TransactionHeader, req *resource.QueryCommittedChaincodesRequest) (*fab.TransactionProposal, error)
- func (fake *MockLifecycleResource) CreateQueryCommittedProposalArgsForCall(i int) (fab.TransactionHeader, *resource.QueryCommittedChaincodesRequest)
- func (fake *MockLifecycleResource) CreateQueryCommittedProposalCallCount() int
- func (fake *MockLifecycleResource) CreateQueryCommittedProposalReturns(result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) CreateQueryCommittedProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
- func (fake *MockLifecycleResource) GetInstalledPackage(reqCtx reqContext.Context, packageID string, target fab.ProposalProcessor, ...) ([]byte, error)
- func (fake *MockLifecycleResource) GetInstalledPackageArgsForCall(i int) (reqContext.Context, string, fab.ProposalProcessor, []resource.Opt)
- func (fake *MockLifecycleResource) GetInstalledPackageCallCount() int
- func (fake *MockLifecycleResource) GetInstalledPackageReturns(result1 []byte, result2 error)
- func (fake *MockLifecycleResource) GetInstalledPackageReturnsOnCall(i int, result1 []byte, result2 error)
- func (fake *MockLifecycleResource) Install(reqCtx reqContext.Context, installPkg []byte, targets []fab.ProposalProcessor, ...) ([]*resource.LifecycleInstallProposalResponse, error)
- func (fake *MockLifecycleResource) InstallArgsForCall(i int) (reqContext.Context, []byte, []fab.ProposalProcessor, []resource.Opt)
- func (fake *MockLifecycleResource) InstallCallCount() int
- func (fake *MockLifecycleResource) InstallReturns(result1 []*resource.LifecycleInstallProposalResponse, result2 error)
- func (fake *MockLifecycleResource) InstallReturnsOnCall(i int, result1 []*resource.LifecycleInstallProposalResponse, result2 error)
- func (fake *MockLifecycleResource) Invocations() map[string][][]interface{}
- func (fake *MockLifecycleResource) QueryApproved(reqCtx reqContext.Context, channelID string, ...) (*resource.LifecycleQueryApprovedCCResponse, error)
- func (fake *MockLifecycleResource) QueryApprovedArgsForCall(i int) (reqContext.Context, string, *resource.QueryApprovedChaincodeRequest, ...)
- func (fake *MockLifecycleResource) QueryApprovedCallCount() int
- func (fake *MockLifecycleResource) QueryApprovedReturns(result1 *resource.LifecycleQueryApprovedCCResponse, result2 error)
- func (fake *MockLifecycleResource) QueryApprovedReturnsOnCall(i int, result1 *resource.LifecycleQueryApprovedCCResponse, result2 error)
- func (fake *MockLifecycleResource) QueryInstalled(reqCtx reqContext.Context, target fab.ProposalProcessor, opts ...resource.Opt) (*resource.LifecycleQueryInstalledCCResponse, error)
- func (fake *MockLifecycleResource) QueryInstalledArgsForCall(i int) (reqContext.Context, fab.ProposalProcessor, []resource.Opt)
- func (fake *MockLifecycleResource) QueryInstalledCallCount() int
- func (fake *MockLifecycleResource) QueryInstalledReturns(result1 *resource.LifecycleQueryInstalledCCResponse, result2 error)
- func (fake *MockLifecycleResource) QueryInstalledReturnsOnCall(i int, result1 *resource.LifecycleQueryInstalledCCResponse, result2 error)
- func (fake *MockLifecycleResource) UnmarshalApplicationPolicy(policyBytes []byte) (*common.SignaturePolicyEnvelope, string, error)
- func (fake *MockLifecycleResource) UnmarshalApplicationPolicyArgsForCall(i int) []byte
- func (fake *MockLifecycleResource) UnmarshalApplicationPolicyCallCount() int
- func (fake *MockLifecycleResource) UnmarshalApplicationPolicyReturns(result1 *common.SignaturePolicyEnvelope, result2 string, result3 error)
- func (fake *MockLifecycleResource) UnmarshalApplicationPolicyReturnsOnCall(i int, result1 *common.SignaturePolicyEnvelope, result2 string, result3 error)
- type MockTransactor
- func (fake *MockTransactor) CreateTransaction(request fab.TransactionRequest) (*fab.Transaction, error)
- func (fake *MockTransactor) CreateTransactionArgsForCall(i int) fab.TransactionRequest
- func (fake *MockTransactor) CreateTransactionCallCount() int
- func (fake *MockTransactor) CreateTransactionHeader(opts ...fab.TxnHeaderOpt) (fab.TransactionHeader, error)
- func (fake *MockTransactor) CreateTransactionHeaderArgsForCall(i int) []fab.TxnHeaderOpt
- func (fake *MockTransactor) CreateTransactionHeaderCallCount() int
- func (fake *MockTransactor) CreateTransactionHeaderReturns(result1 fab.TransactionHeader, result2 error)
- func (fake *MockTransactor) CreateTransactionHeaderReturnsOnCall(i int, result1 fab.TransactionHeader, result2 error)
- func (fake *MockTransactor) CreateTransactionReturns(result1 *fab.Transaction, result2 error)
- func (fake *MockTransactor) CreateTransactionReturnsOnCall(i int, result1 *fab.Transaction, result2 error)
- func (fake *MockTransactor) Invocations() map[string][][]interface{}
- func (fake *MockTransactor) SendTransaction(tx *fab.Transaction) (*fab.TransactionResponse, error)
- func (fake *MockTransactor) SendTransactionArgsForCall(i int) *fab.Transaction
- func (fake *MockTransactor) SendTransactionCallCount() int
- func (fake *MockTransactor) SendTransactionProposal(arg1 *fab.TransactionProposal, arg2 []fab.ProposalProcessor) ([]*fab.TransactionProposalResponse, error)
- func (fake *MockTransactor) SendTransactionProposalArgsForCall(i int) (*fab.TransactionProposal, []fab.ProposalProcessor)
- func (fake *MockTransactor) SendTransactionProposalCallCount() int
- func (fake *MockTransactor) SendTransactionProposalReturns(result1 []*fab.TransactionProposalResponse, result2 error)
- func (fake *MockTransactor) SendTransactionProposalReturnsOnCall(i int, result1 []*fab.TransactionProposalResponse, result2 error)
- func (fake *MockTransactor) SendTransactionReturns(result1 *fab.TransactionResponse, result2 error)
- func (fake *MockTransactor) SendTransactionReturnsOnCall(i int, result1 *fab.TransactionResponse, result2 error)
- type RequestOption
- func WithConfigSignatures(signatures ...*common.ConfigSignature) RequestOption
- func WithOrderer(orderer fab.Orderer) RequestOption
- func WithOrdererEndpoint(key string) RequestOption
- func WithParentContext(parentContext reqContext.Context) RequestOption
- func WithRetry(retryOpt retry.Opts) RequestOption
- func WithTargetEndpoints(keys ...string) RequestOption
- func WithTargetFilter(targetFilter fab.TargetFilter) RequestOption
- func WithTargets(targets ...fab.Peer) RequestOption
- func WithTimeout(timeoutType fab.TimeoutType, timeout time.Duration) RequestOption
- type SaveChannelRequest
- type SaveChannelResponse
- type UpgradeCCRequest
- type UpgradeCCResponse
Examples ¶
- Package
- Client.InstallCC
- Client.InstantiateCC
- Client.JoinChannel
- Client.QueryChannels
- Client.QueryInstalledChaincodes
- Client.QueryInstantiatedChaincodes
- Client.SaveChannel
- Client.SaveChannel (WithOrdererEndpoint)
- Client.UpgradeCC
- New
- WithDefaultTargetFilter
- WithParentContext
- WithTargetFilter
- WithTargets
Constants ¶
const ( InstantiateChaincode chaincodeProposalType = iota UpgradeChaincode )
Define chaincode proposal types
Variables ¶
This section is empty.
Functions ¶
func CalculateConfigUpdate ¶
func CalculateConfigUpdate(channelID string, currentConfig, newConfig *common.Config) (*common.ConfigUpdate, error)
CalculateConfigUpdate calculates channel config update based on the difference between provided current channel config and proposed new channel config.
func MarshalConfigSignature ¶
func MarshalConfigSignature(signature *common.ConfigSignature) ([]byte, error)
MarshalConfigSignature marshals 1 ConfigSignature for the given client concatenated as []byte
func UnmarshalConfigSignature ¶
func UnmarshalConfigSignature(reader io.Reader) (*common.ConfigSignature, error)
UnmarshalConfigSignature reads 1 ConfigSignature as []byte from reader and unmarshals it
Types ¶
type CCReference ¶
type CCReference struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` }
CCReference contains the name and version of an instantiated chaincode that references the installed chaincode package.
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client enables managing resources in Fabric network.
func New ¶
func New(ctxProvider context.ClientProvider, opts ...ClientOption) (*Client, error)
New returns a resource management client instance.
Example ¶
ctx := mockClientProvider() c, err := New(ctx) if err != nil { fmt.Println("failed to create client") } if c != nil { fmt.Println("resource management client created") }
Output: resource management client created
func (*Client) CreateConfigSignature ¶
func (rc *Client) CreateConfigSignature(signer msp.SigningIdentity, channelConfigPath string) (*common.ConfigSignature, error)
CreateConfigSignature creates a signature for the given client, custom signers and chConfig from channelConfigPath argument
return ConfigSignature will be signed internally by the SDK. It can be passed to WithConfigSignatures() option
Deprecated: this method is deprecated in order to use CreateConfigSignatureFromReader
func (*Client) CreateConfigSignatureData ¶
func (rc *Client) CreateConfigSignatureData(signer msp.SigningIdentity, channelConfigPath string) (signatureHeaderData resource.ConfigSignatureData, e error)
CreateConfigSignatureData will prepare a SignatureHeader and the full signing []byte (signingBytes) to be used for signing a Channel Config Deprecated: this method is deprecated in order to use CreateConfigSignatureDataFromReader
func (*Client) CreateConfigSignatureDataFromReader ¶
func (rc *Client) CreateConfigSignatureDataFromReader(signer msp.SigningIdentity, channelConfig io.Reader) (signatureHeaderData resource.ConfigSignatureData, e error)
CreateConfigSignatureDataFromReader will prepare a SignatureHeader and the full signing []byte (signingBytes) to be used for signing a Channel Config
Once SigningBytes have been signed externally (signing signatureHeaderData.SigningBytes using an external tool like OpenSSL), do the following: 1. create a common.ConfigSignature{} instance 2. assign its SignatureHeader field with the returned field 'signatureHeaderData.signatureHeader' 3. assign its Signature field with the generated signature of 'signatureHeaderData.signingBytes' from the external tool Then use WithConfigSignatures() option to pass this new instance for channel updates
func (*Client) CreateConfigSignatureFromReader ¶
func (rc *Client) CreateConfigSignatureFromReader(signer msp.SigningIdentity, channelConfig io.Reader) (*common.ConfigSignature, error)
CreateConfigSignatureFromReader creates a signature for the given client, custom signers and chConfig from io.Reader argument
return ConfigSignature will be signed internally by the SDK. It can be passed to WithConfigSignatures() option
func (*Client) InstallCC ¶
func (rc *Client) InstallCC(req InstallCCRequest, options ...RequestOption) ([]InstallCCResponse, error)
InstallCC allows administrators to install chaincode onto the filesystem of a peer. If peer(s) are not specified in options it will default to all peers that belong to admin's MSP.
Parameters: req holds info about mandatory chaincode name, path, version and policy options holds optional request options Returns: install chaincode proposal responses from peer(s)
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } req := InstallCCRequest{Name: "ExampleCC", Version: "v0", Path: "path", Package: &resource.CCPackage{Type: 1, Code: []byte("bytes")}} responses, err := c.InstallCC(req, WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to install chaincode: %s\n", err) } if len(responses) > 0 { fmt.Println("Chaincode installed") }
Output: Chaincode installed
func (*Client) InstantiateCC ¶
func (rc *Client) InstantiateCC(channelID string, req InstantiateCCRequest, options ...RequestOption) (InstantiateCCResponse, error)
InstantiateCC instantiates chaincode with optional custom options (specific peers, filtered peers, timeout). If peer(s) are not specified in options it will default to all channel peers.
Parameters: channel is manadatory channel name req holds info about mandatory chaincode name, path, version and policy options holds optional request options Returns: instantiate chaincode response with transaction ID
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } ccPolicy := policydsl.SignedByMspMember("Org1MSP") req := InstantiateCCRequest{Name: "ExampleCC", Version: "v0", Path: "path", Policy: ccPolicy} resp, err := c.InstantiateCC("mychannel", req) if err != nil { fmt.Printf("failed to install chaincode: %s\n", err) } if resp.TransactionID == "" { fmt.Println("Failed to instantiate chaincode") } fmt.Println("Chaincode instantiated")
Output: Chaincode instantiated
func (*Client) JoinChannel ¶
func (rc *Client) JoinChannel(channelID string, options ...RequestOption) error
JoinChannel allows for peers to join existing channel with optional custom options (specific peers, filtered peers). If peer(s) are not specified in options it will default to all peers that belong to client's MSP.
Parameters: channel is manadatory channel name options holds optional request options Returns: an error if join fails
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } err = c.JoinChannel("mychannel", WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to join channel: %s\n", err) } fmt.Println("Joined channel")
Output: Joined channel
func (*Client) LifecycleApproveCC ¶
func (rc *Client) LifecycleApproveCC(channelID string, req LifecycleApproveCCRequest, options ...RequestOption) (fab.TransactionID, error)
LifecycleApproveCC approves a chaincode for an organization.
func (*Client) LifecycleCheckCCCommitReadiness ¶
func (rc *Client) LifecycleCheckCCCommitReadiness(channelID string, req LifecycleCheckCCCommitReadinessRequest, options ...RequestOption) (LifecycleCheckCCCommitReadinessResponse, error)
LifecycleCheckCCCommitReadiness checks the 'commit readiness' of a chaincode. Returned are the org approvals.
func (*Client) LifecycleCommitCC ¶
func (rc *Client) LifecycleCommitCC(channelID string, req LifecycleCommitCCRequest, options ...RequestOption) (fab.TransactionID, error)
LifecycleCommitCC commits the chaincode to the given channel
func (*Client) LifecycleGetInstalledCCPackage ¶
func (rc *Client) LifecycleGetInstalledCCPackage(packageID string, options ...RequestOption) ([]byte, error)
LifecycleGetInstalledCCPackage retrieves the installed chaincode package for the given package ID. NOTE: The package ID may be computed with fab/ccpackager/lifecycle.ComputePackageID.
func (*Client) LifecycleInstallCC ¶
func (rc *Client) LifecycleInstallCC(req LifecycleInstallCCRequest, options ...RequestOption) ([]LifecycleInstallCCResponse, error)
LifecycleInstallCC installs a chaincode package using Fabric 2.0 chaincode lifecycle.
func (*Client) LifecycleQueryApprovedCC ¶
func (rc *Client) LifecycleQueryApprovedCC(channelID string, req LifecycleQueryApprovedCCRequest, options ...RequestOption) (LifecycleApprovedChaincodeDefinition, error)
LifecycleQueryApprovedCC returns information about the approved chaincode definition
func (*Client) LifecycleQueryCommittedCC ¶
func (rc *Client) LifecycleQueryCommittedCC(channelID string, req LifecycleQueryCommittedCCRequest, options ...RequestOption) ([]LifecycleChaincodeDefinition, error)
LifecycleQueryCommittedCC queries for committed chaincodes on a given channel
func (*Client) LifecycleQueryInstalledCC ¶
func (rc *Client) LifecycleQueryInstalledCC(options ...RequestOption) ([]LifecycleInstalledCC, error)
LifecycleQueryInstalledCC returns the chaincodes that were installed on a given peer with Fabric 2.0 chaincode lifecycle.
func (*Client) QueryChannels ¶
func (rc *Client) QueryChannels(options ...RequestOption) (*pb.ChannelQueryResponse, error)
QueryChannels queries the names of all the channels that a peer has joined.
Parameters: options hold optional request options Note: One target(peer) has to be specified using either WithTargetURLs or WithTargets request option Returns: all channels that peer has joined
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } response, err := c.QueryChannels(WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to query channels: %s\n", err) } if response != nil { fmt.Println("Retrieved channels") }
Output: Retrieved channels
func (*Client) QueryCollectionsConfig ¶
func (rc *Client) QueryCollectionsConfig(channelID string, chaincodeName string, options ...RequestOption) (*pb.CollectionConfigPackage, error)
QueryCollectionsConfig queries the collections config on a peer for specific channel. If peer is not specified in options it will query random peer on this channel. Parameters: channel is mandatory channel name chaincode is mandatory chaincode name options hold optional request options
Returns: list of collections config
func (*Client) QueryConfigBlockFromOrderer ¶
func (rc *Client) QueryConfigBlockFromOrderer(channelID string, options ...RequestOption) (*common.Block, error)
QueryConfigBlockFromOrderer config returns channel configuration block from orderer. If orderer is not provided using options it will be defaulted to channel orderer (if configured) or random orderer from configuration.
Parameters: channelID is mandatory channel ID options holds optional request options Returns: channel configuration block
func (*Client) QueryConfigFromOrderer ¶
func (rc *Client) QueryConfigFromOrderer(channelID string, options ...RequestOption) (fab.ChannelCfg, error)
QueryConfigFromOrderer config returns channel configuration from orderer. If orderer is not provided using options it will be defaulted to channel orderer (if configured) or random orderer from configuration.
Parameters: channelID is mandatory channel ID options holds optional request options Returns: channel configuration
func (*Client) QueryInstalledChaincodes ¶
func (rc *Client) QueryInstalledChaincodes(options ...RequestOption) (*pb.ChaincodeQueryResponse, error)
QueryInstalledChaincodes queries the installed chaincodes on a peer.
Parameters: options hold optional request options Note: One target(peer) has to be specified using either WithTargetURLs or WithTargets request option Returns: list of installed chaincodes on specified peer
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } response, err := c.QueryInstalledChaincodes(WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to query installed chaincodes: %s\n", err) } if response != nil { fmt.Println("Retrieved installed chaincodes") }
Output: Retrieved installed chaincodes
func (*Client) QueryInstantiatedChaincodes ¶
func (rc *Client) QueryInstantiatedChaincodes(channelID string, options ...RequestOption) (*pb.ChaincodeQueryResponse, error)
QueryInstantiatedChaincodes queries the instantiated chaincodes on a peer for specific channel. If peer is not specified in options it will query random peer on this channel.
Parameters: channel is manadatory channel name options hold optional request options Returns: list of instantiated chaincodes
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } response, err := c.QueryInstantiatedChaincodes("mychannel", WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to query instantiated chaincodes: %s\n", err) } if response != nil { fmt.Println("Retrieved instantiated chaincodes") }
Output: Retrieved instantiated chaincodes
func (*Client) SaveChannel ¶
func (rc *Client) SaveChannel(req SaveChannelRequest, options ...RequestOption) (SaveChannelResponse, error)
SaveChannel creates or updates channel.
Parameters: req holds info about mandatory channel name and configuration options holds optional request options if options have signatures (WithConfigSignatures() or 1 or more WithConfigSignature() calls), then SaveChannel will use these signatures instead of creating ones for the SigningIdentities found in req. Make sure that req.ChannelConfigPath/req.ChannelConfig have the channel config matching these signatures. Returns: save channel response with transaction ID
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Printf("failed to create client: %s\n", err) } channelConfigTxPath := filepath.Join(metadata.GetProjectPath(), metadata.ChannelConfigPath, channelConfigTxFile) r, err := os.Open(channelConfigTxPath) if err != nil { fmt.Printf("failed to open channel config: %s\n", err) } defer r.Close() resp, err := c.SaveChannel(SaveChannelRequest{ChannelID: "mychannel", ChannelConfig: r}) if err != nil { fmt.Printf("failed to save channel: %s\n", err) } if resp.TransactionID == "" { fmt.Println("Failed to save channel") } fmt.Println("Saved channel")
Output: Saved channel
Example (WithOrdererEndpoint) ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Printf("failed to create client: %s\n", err) } channelConfigTxPath := filepath.Join(metadata.GetProjectPath(), metadata.ChannelConfigPath, channelConfigTxFile) r, err := os.Open(channelConfigTxPath) if err != nil { fmt.Printf("failed to open channel config: %s\n", err) } defer r.Close() resp, err := c.SaveChannel(SaveChannelRequest{ChannelID: "mychannel", ChannelConfig: r}, WithOrdererEndpoint("example.com")) if err != nil { fmt.Printf("failed to save channel: %s\n", err) } if resp.TransactionID == "" { fmt.Println("Failed to save channel") } fmt.Println("Saved channel")
Output: Saved channel
func (*Client) UpgradeCC ¶
func (rc *Client) UpgradeCC(channelID string, req UpgradeCCRequest, options ...RequestOption) (UpgradeCCResponse, error)
UpgradeCC upgrades chaincode with optional custom options (specific peers, filtered peers, timeout). If peer(s) are not specified in options it will default to all channel peers.
Parameters: channel is manadatory channel name req holds info about mandatory chaincode name, path, version and policy options holds optional request options Returns: upgrade chaincode response with transaction ID
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } ccPolicy := policydsl.SignedByMspMember("Org1MSP") req := UpgradeCCRequest{Name: "ExampleCC", Version: "v1", Path: "path", Policy: ccPolicy} resp, err := c.UpgradeCC("mychannel", req, WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to upgrade chaincode: %s\n", err) } if resp.TransactionID == "" { fmt.Println("Failed to upgrade chaincode") } fmt.Println("Chaincode upgraded")
Output: Chaincode upgraded
type ClientOption ¶
ClientOption describes a functional parameter for the New constructor
func WithDefaultTargetFilter ¶
func WithDefaultTargetFilter(filter fab.TargetFilter) ClientOption
WithDefaultTargetFilter option to configure default target filter per client
Example ¶
ctx := mockClientProvider() c, err := New(ctx, WithDefaultTargetFilter(&urlTargetFilter{url: "example.com"})) if err != nil { fmt.Println("failed to create client") } if c != nil { fmt.Println("resource management client created with url target filter") }
Output: resource management client created with url target filter
type InstallCCRequest ¶
InstallCCRequest contains install chaincode request parameters
type InstallCCResponse ¶
InstallCCResponse contains install chaincode response status
type InstantiateCCRequest ¶
type InstantiateCCRequest struct { Name string Path string Version string Lang pb.ChaincodeSpec_Type Args [][]byte Policy *common.SignaturePolicyEnvelope CollConfig []*pb.CollectionConfig }
InstantiateCCRequest contains instantiate chaincode request parameters
type InstantiateCCResponse ¶
type InstantiateCCResponse struct {
TransactionID fab.TransactionID
}
InstantiateCCResponse contains response parameters for instantiate chaincode
type LifecycleApproveCCRequest ¶
type LifecycleApproveCCRequest struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` PackageID string `json:"packageID,omitempty"` Sequence int64 `json:"sequence,omitempty"` EndorsementPlugin string `json:"endorsementPlugin,omitempty"` ValidationPlugin string `json:"validationPlugin,omitempty"` SignaturePolicy *common.SignaturePolicyEnvelope `json:"signaturePolicy,omitempty"` ChannelConfigPolicy string `json:"channelConfigPolicy,omitempty"` CollectionConfig []*pb.CollectionConfig `json:"collectionConfig,omitempty"` InitRequired bool `json:"initRequired,omitempty"` }
LifecycleApproveCCRequest contains the parameters for approving a chaincode for an org.
type LifecycleApprovedChaincodeDefinition ¶
type LifecycleApprovedChaincodeDefinition struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` Sequence int64 `json:"sequence,omitempty"` EndorsementPlugin string `json:"endorsementPlugin,omitempty"` ValidationPlugin string `json:"validationPlugin,omitempty"` SignaturePolicy *common.SignaturePolicyEnvelope `json:"signaturePolicy,omitempty"` ChannelConfigPolicy string `json:"channelConfigPolicy,omitempty"` CollectionConfig []*pb.CollectionConfig `json:"collectionConfig,omitempty"` InitRequired bool `json:"initRequired,omitempty"` PackageID string `json:"packageID,omitempty"` }
LifecycleApprovedChaincodeDefinition contains information about the approved chaincode
type LifecycleChaincodeDefinition ¶
type LifecycleChaincodeDefinition struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` Sequence int64 `json:"sequence,omitempty"` EndorsementPlugin string `json:"endorsementPlugin,omitempty"` ValidationPlugin string `json:"validationPlugin,omitempty"` SignaturePolicy *common.SignaturePolicyEnvelope `json:"signaturePolicy,omitempty"` ChannelConfigPolicy string `json:"channelConfigPolicy,omitempty"` CollectionConfig []*pb.CollectionConfig `json:"collectionConfig,omitempty"` InitRequired bool `json:"initRequired,omitempty"` Approvals map[string]bool `json:"approvals,omitempty"` }
LifecycleChaincodeDefinition contains information about a committed chaincode. Note that approvals are only returned if a chaincode name is provided in the request.
type LifecycleCheckCCCommitReadinessRequest ¶
type LifecycleCheckCCCommitReadinessRequest struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` Sequence int64 `json:"sequence,omitempty"` EndorsementPlugin string `json:"endorsementPlugin,omitempty"` ValidationPlugin string `json:"validationPlugin,omitempty"` SignaturePolicy *common.SignaturePolicyEnvelope `json:"signaturePolicy,omitempty"` ChannelConfigPolicy string `json:"channelConfigPolicy,omitempty"` CollectionConfig []*pb.CollectionConfig `json:"collectionConfig,omitempty"` InitRequired bool `json:"initRequired,omitempty"` }
LifecycleCheckCCCommitReadinessRequest contains the parameters for checking the 'commit readiness' of a chaincode
type LifecycleCheckCCCommitReadinessResponse ¶
type LifecycleCheckCCCommitReadinessResponse struct {
Approvals map[string]bool `json:"approvals,omitempty"`
}
LifecycleCheckCCCommitReadinessResponse contains the org approvals for the chaincode
type LifecycleCommitCCRequest ¶
type LifecycleCommitCCRequest struct { Name string `json:"name,omitempty"` Version string `json:"version,omitempty"` Sequence int64 `json:"sequence,omitempty"` EndorsementPlugin string `json:"endorsementPlugin,omitempty"` ValidationPlugin string `json:"validationPlugin,omitempty"` SignaturePolicy *common.SignaturePolicyEnvelope `json:"signaturePolicy,omitempty"` ChannelConfigPolicy string `json:"channelConfigPolicy,omitempty"` CollectionConfig []*pb.CollectionConfig `json:"collectionConfig,omitempty"` InitRequired bool `json:"initRequired,omitempty"` }
LifecycleCommitCCRequest contains the parameters for committing a chaincode
type LifecycleInstallCCRequest ¶
type LifecycleInstallCCRequest struct { Label string `json:"label,omitempty"` Package []byte `json:"package,omitempty"` }
LifecycleInstallCCRequest contains the parameters for installing chaincode
type LifecycleInstallCCResponse ¶
type LifecycleInstallCCResponse struct { Target string `json:"target,omitempty"` Status int32 `json:"status,omitempty"` PackageID string `json:"packageID,omitempty"` }
LifecycleInstallCCResponse contains the response from a chaincode installation
type LifecycleInstalledCC ¶
type LifecycleInstalledCC struct { PackageID string `json:"packageID,omitempty"` Label string `json:"label,omitempty"` References map[string][]CCReference `json:"references,omitempty"` }
LifecycleInstalledCC contains the package ID and label of the installed chaincode, including a map of channel name to chaincode name and version pairs of chaincode definitions that reference this chaincode package.
type LifecycleQueryApprovedCCRequest ¶
type LifecycleQueryApprovedCCRequest struct { Name string `json:"name,omitempty"` Sequence int64 `json:"sequence,omitempty"` }
LifecycleQueryApprovedCCRequest contains the parameters for querying approved chaincodes
type LifecycleQueryCommittedCCRequest ¶
type LifecycleQueryCommittedCCRequest struct {
Name string `json:"name,omitempty"`
}
LifecycleQueryCommittedCCRequest contains the parameters to query committed chaincodes. If name is not provided then all committed chaincodes on the given channel are returned, otherwise only the chaincode with the given name is returned.
type MockChannelProvider ¶
type MockChannelProvider struct { ChannelServiceStub func(ctx fab.ClientContext, channelID string) (fab.ChannelService, error) // contains filtered or unexported fields }
func (*MockChannelProvider) ChannelService ¶
func (fake *MockChannelProvider) ChannelService(ctx fab.ClientContext, channelID string) (fab.ChannelService, error)
func (*MockChannelProvider) ChannelServiceArgsForCall ¶
func (fake *MockChannelProvider) ChannelServiceArgsForCall(i int) (fab.ClientContext, string)
func (*MockChannelProvider) ChannelServiceCallCount ¶
func (fake *MockChannelProvider) ChannelServiceCallCount() int
func (*MockChannelProvider) ChannelServiceReturns ¶
func (fake *MockChannelProvider) ChannelServiceReturns(result1 fab.ChannelService, result2 error)
func (*MockChannelProvider) ChannelServiceReturnsOnCall ¶
func (fake *MockChannelProvider) ChannelServiceReturnsOnCall(i int, result1 fab.ChannelService, result2 error)
func (*MockChannelProvider) Invocations ¶
func (fake *MockChannelProvider) Invocations() map[string][][]interface{}
type MockChannelService ¶
type MockChannelService struct { ConfigStub func() (fab.ChannelConfig, error) EventServiceStub func(opts ...options.Opt) (fab.EventService, error) MembershipStub func() (fab.ChannelMembership, error) ChannelConfigStub func() (fab.ChannelCfg, error) TransactorStub func(reqCtx reqContext.Context) (fab.Transactor, error) DiscoveryStub func() (fab.DiscoveryService, error) SelectionStub func() (fab.SelectionService, error) // contains filtered or unexported fields }
func (*MockChannelService) ChannelConfig ¶
func (fake *MockChannelService) ChannelConfig() (fab.ChannelCfg, error)
func (*MockChannelService) ChannelConfigCallCount ¶
func (fake *MockChannelService) ChannelConfigCallCount() int
func (*MockChannelService) ChannelConfigReturns ¶
func (fake *MockChannelService) ChannelConfigReturns(result1 fab.ChannelCfg, result2 error)
func (*MockChannelService) ChannelConfigReturnsOnCall ¶
func (fake *MockChannelService) ChannelConfigReturnsOnCall(i int, result1 fab.ChannelCfg, result2 error)
func (*MockChannelService) Config ¶
func (fake *MockChannelService) Config() (fab.ChannelConfig, error)
func (*MockChannelService) ConfigCallCount ¶
func (fake *MockChannelService) ConfigCallCount() int
func (*MockChannelService) ConfigReturns ¶
func (fake *MockChannelService) ConfigReturns(result1 fab.ChannelConfig, result2 error)
func (*MockChannelService) ConfigReturnsOnCall ¶
func (fake *MockChannelService) ConfigReturnsOnCall(i int, result1 fab.ChannelConfig, result2 error)
func (*MockChannelService) Discovery ¶
func (fake *MockChannelService) Discovery() (fab.DiscoveryService, error)
func (*MockChannelService) DiscoveryCallCount ¶
func (fake *MockChannelService) DiscoveryCallCount() int
func (*MockChannelService) DiscoveryReturns ¶
func (fake *MockChannelService) DiscoveryReturns(result1 fab.DiscoveryService, result2 error)
func (*MockChannelService) DiscoveryReturnsOnCall ¶
func (fake *MockChannelService) DiscoveryReturnsOnCall(i int, result1 fab.DiscoveryService, result2 error)
func (*MockChannelService) EventService ¶
func (fake *MockChannelService) EventService(opts ...options.Opt) (fab.EventService, error)
func (*MockChannelService) EventServiceArgsForCall ¶
func (fake *MockChannelService) EventServiceArgsForCall(i int) []options.Opt
func (*MockChannelService) EventServiceCallCount ¶
func (fake *MockChannelService) EventServiceCallCount() int
func (*MockChannelService) EventServiceReturns ¶
func (fake *MockChannelService) EventServiceReturns(result1 fab.EventService, result2 error)
func (*MockChannelService) EventServiceReturnsOnCall ¶
func (fake *MockChannelService) EventServiceReturnsOnCall(i int, result1 fab.EventService, result2 error)
func (*MockChannelService) Invocations ¶
func (fake *MockChannelService) Invocations() map[string][][]interface{}
func (*MockChannelService) Membership ¶
func (fake *MockChannelService) Membership() (fab.ChannelMembership, error)
func (*MockChannelService) MembershipCallCount ¶
func (fake *MockChannelService) MembershipCallCount() int
func (*MockChannelService) MembershipReturns ¶
func (fake *MockChannelService) MembershipReturns(result1 fab.ChannelMembership, result2 error)
func (*MockChannelService) MembershipReturnsOnCall ¶
func (fake *MockChannelService) MembershipReturnsOnCall(i int, result1 fab.ChannelMembership, result2 error)
func (*MockChannelService) Selection ¶
func (fake *MockChannelService) Selection() (fab.SelectionService, error)
func (*MockChannelService) SelectionCallCount ¶
func (fake *MockChannelService) SelectionCallCount() int
func (*MockChannelService) SelectionReturns ¶
func (fake *MockChannelService) SelectionReturns(result1 fab.SelectionService, result2 error)
func (*MockChannelService) SelectionReturnsOnCall ¶
func (fake *MockChannelService) SelectionReturnsOnCall(i int, result1 fab.SelectionService, result2 error)
func (*MockChannelService) Transactor ¶
func (fake *MockChannelService) Transactor(reqCtx reqContext.Context) (fab.Transactor, error)
func (*MockChannelService) TransactorArgsForCall ¶
func (fake *MockChannelService) TransactorArgsForCall(i int) reqContext.Context
func (*MockChannelService) TransactorCallCount ¶
func (fake *MockChannelService) TransactorCallCount() int
func (*MockChannelService) TransactorReturns ¶
func (fake *MockChannelService) TransactorReturns(result1 fab.Transactor, result2 error)
func (*MockChannelService) TransactorReturnsOnCall ¶
func (fake *MockChannelService) TransactorReturnsOnCall(i int, result1 fab.Transactor, result2 error)
type MockLifecycleResource ¶
type MockLifecycleResource struct { InstallStub func(reqCtx reqContext.Context, installPkg []byte, targets []fab.ProposalProcessor, opts ...resource.Opt) ([]*resource.LifecycleInstallProposalResponse, error) GetInstalledPackageStub func(reqCtx reqContext.Context, packageID string, target fab.ProposalProcessor, opts ...resource.Opt) ([]byte, error) QueryInstalledStub func(reqCtx reqContext.Context, target fab.ProposalProcessor, opts ...resource.Opt) (*resource.LifecycleQueryInstalledCCResponse, error) QueryApprovedStub func(reqCtx reqContext.Context, channelID string, req *resource.QueryApprovedChaincodeRequest, target fab.ProposalProcessor, opts ...resource.Opt) (*resource.LifecycleQueryApprovedCCResponse, error) CreateApproveProposalStub func(txh fab.TransactionHeader, req *resource.ApproveChaincodeRequest) (*fab.TransactionProposal, error) CreateCheckCommitReadinessProposalStub func(txh fab.TransactionHeader, req *resource.CheckChaincodeCommitReadinessRequest) (*fab.TransactionProposal, error) CreateCommitProposalStub func(txh fab.TransactionHeader, req *resource.CommitChaincodeRequest) (*fab.TransactionProposal, error) CreateQueryCommittedProposalStub func(txh fab.TransactionHeader, req *resource.QueryCommittedChaincodesRequest) (*fab.TransactionProposal, error) UnmarshalApplicationPolicyStub func(policyBytes []byte) (*common.SignaturePolicyEnvelope, string, error) // contains filtered or unexported fields }
func (*MockLifecycleResource) CreateApproveProposal ¶
func (fake *MockLifecycleResource) CreateApproveProposal(txh fab.TransactionHeader, req *resource.ApproveChaincodeRequest) (*fab.TransactionProposal, error)
func (*MockLifecycleResource) CreateApproveProposalArgsForCall ¶
func (fake *MockLifecycleResource) CreateApproveProposalArgsForCall(i int) (fab.TransactionHeader, *resource.ApproveChaincodeRequest)
func (*MockLifecycleResource) CreateApproveProposalCallCount ¶
func (fake *MockLifecycleResource) CreateApproveProposalCallCount() int
func (*MockLifecycleResource) CreateApproveProposalReturns ¶
func (fake *MockLifecycleResource) CreateApproveProposalReturns(result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateApproveProposalReturnsOnCall ¶
func (fake *MockLifecycleResource) CreateApproveProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateCheckCommitReadinessProposal ¶
func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposal(txh fab.TransactionHeader, req *resource.CheckChaincodeCommitReadinessRequest) (*fab.TransactionProposal, error)
func (*MockLifecycleResource) CreateCheckCommitReadinessProposalArgsForCall ¶
func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalArgsForCall(i int) (fab.TransactionHeader, *resource.CheckChaincodeCommitReadinessRequest)
func (*MockLifecycleResource) CreateCheckCommitReadinessProposalCallCount ¶
func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalCallCount() int
func (*MockLifecycleResource) CreateCheckCommitReadinessProposalReturns ¶
func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalReturns(result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateCheckCommitReadinessProposalReturnsOnCall ¶
func (fake *MockLifecycleResource) CreateCheckCommitReadinessProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateCommitProposal ¶
func (fake *MockLifecycleResource) CreateCommitProposal(txh fab.TransactionHeader, req *resource.CommitChaincodeRequest) (*fab.TransactionProposal, error)
func (*MockLifecycleResource) CreateCommitProposalArgsForCall ¶
func (fake *MockLifecycleResource) CreateCommitProposalArgsForCall(i int) (fab.TransactionHeader, *resource.CommitChaincodeRequest)
func (*MockLifecycleResource) CreateCommitProposalCallCount ¶
func (fake *MockLifecycleResource) CreateCommitProposalCallCount() int
func (*MockLifecycleResource) CreateCommitProposalReturns ¶
func (fake *MockLifecycleResource) CreateCommitProposalReturns(result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateCommitProposalReturnsOnCall ¶
func (fake *MockLifecycleResource) CreateCommitProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateQueryCommittedProposal ¶
func (fake *MockLifecycleResource) CreateQueryCommittedProposal(txh fab.TransactionHeader, req *resource.QueryCommittedChaincodesRequest) (*fab.TransactionProposal, error)
func (*MockLifecycleResource) CreateQueryCommittedProposalArgsForCall ¶
func (fake *MockLifecycleResource) CreateQueryCommittedProposalArgsForCall(i int) (fab.TransactionHeader, *resource.QueryCommittedChaincodesRequest)
func (*MockLifecycleResource) CreateQueryCommittedProposalCallCount ¶
func (fake *MockLifecycleResource) CreateQueryCommittedProposalCallCount() int
func (*MockLifecycleResource) CreateQueryCommittedProposalReturns ¶
func (fake *MockLifecycleResource) CreateQueryCommittedProposalReturns(result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) CreateQueryCommittedProposalReturnsOnCall ¶
func (fake *MockLifecycleResource) CreateQueryCommittedProposalReturnsOnCall(i int, result1 *fab.TransactionProposal, result2 error)
func (*MockLifecycleResource) GetInstalledPackage ¶
func (fake *MockLifecycleResource) GetInstalledPackage(reqCtx reqContext.Context, packageID string, target fab.ProposalProcessor, opts ...resource.Opt) ([]byte, error)
func (*MockLifecycleResource) GetInstalledPackageArgsForCall ¶
func (fake *MockLifecycleResource) GetInstalledPackageArgsForCall(i int) (reqContext.Context, string, fab.ProposalProcessor, []resource.Opt)
func (*MockLifecycleResource) GetInstalledPackageCallCount ¶
func (fake *MockLifecycleResource) GetInstalledPackageCallCount() int
func (*MockLifecycleResource) GetInstalledPackageReturns ¶
func (fake *MockLifecycleResource) GetInstalledPackageReturns(result1 []byte, result2 error)
func (*MockLifecycleResource) GetInstalledPackageReturnsOnCall ¶
func (fake *MockLifecycleResource) GetInstalledPackageReturnsOnCall(i int, result1 []byte, result2 error)
func (*MockLifecycleResource) Install ¶
func (fake *MockLifecycleResource) Install(reqCtx reqContext.Context, installPkg []byte, targets []fab.ProposalProcessor, opts ...resource.Opt) ([]*resource.LifecycleInstallProposalResponse, error)
func (*MockLifecycleResource) InstallArgsForCall ¶
func (fake *MockLifecycleResource) InstallArgsForCall(i int) (reqContext.Context, []byte, []fab.ProposalProcessor, []resource.Opt)
func (*MockLifecycleResource) InstallCallCount ¶
func (fake *MockLifecycleResource) InstallCallCount() int
func (*MockLifecycleResource) InstallReturns ¶
func (fake *MockLifecycleResource) InstallReturns(result1 []*resource.LifecycleInstallProposalResponse, result2 error)
func (*MockLifecycleResource) InstallReturnsOnCall ¶
func (fake *MockLifecycleResource) InstallReturnsOnCall(i int, result1 []*resource.LifecycleInstallProposalResponse, result2 error)
func (*MockLifecycleResource) Invocations ¶
func (fake *MockLifecycleResource) Invocations() map[string][][]interface{}
func (*MockLifecycleResource) QueryApproved ¶
func (fake *MockLifecycleResource) QueryApproved(reqCtx reqContext.Context, channelID string, req *resource.QueryApprovedChaincodeRequest, target fab.ProposalProcessor, opts ...resource.Opt) (*resource.LifecycleQueryApprovedCCResponse, error)
func (*MockLifecycleResource) QueryApprovedArgsForCall ¶
func (fake *MockLifecycleResource) QueryApprovedArgsForCall(i int) (reqContext.Context, string, *resource.QueryApprovedChaincodeRequest, fab.ProposalProcessor, []resource.Opt)
func (*MockLifecycleResource) QueryApprovedCallCount ¶
func (fake *MockLifecycleResource) QueryApprovedCallCount() int
func (*MockLifecycleResource) QueryApprovedReturns ¶
func (fake *MockLifecycleResource) QueryApprovedReturns(result1 *resource.LifecycleQueryApprovedCCResponse, result2 error)
func (*MockLifecycleResource) QueryApprovedReturnsOnCall ¶
func (fake *MockLifecycleResource) QueryApprovedReturnsOnCall(i int, result1 *resource.LifecycleQueryApprovedCCResponse, result2 error)
func (*MockLifecycleResource) QueryInstalled ¶
func (fake *MockLifecycleResource) QueryInstalled(reqCtx reqContext.Context, target fab.ProposalProcessor, opts ...resource.Opt) (*resource.LifecycleQueryInstalledCCResponse, error)
func (*MockLifecycleResource) QueryInstalledArgsForCall ¶
func (fake *MockLifecycleResource) QueryInstalledArgsForCall(i int) (reqContext.Context, fab.ProposalProcessor, []resource.Opt)
func (*MockLifecycleResource) QueryInstalledCallCount ¶
func (fake *MockLifecycleResource) QueryInstalledCallCount() int
func (*MockLifecycleResource) QueryInstalledReturns ¶
func (fake *MockLifecycleResource) QueryInstalledReturns(result1 *resource.LifecycleQueryInstalledCCResponse, result2 error)
func (*MockLifecycleResource) QueryInstalledReturnsOnCall ¶
func (fake *MockLifecycleResource) QueryInstalledReturnsOnCall(i int, result1 *resource.LifecycleQueryInstalledCCResponse, result2 error)
func (*MockLifecycleResource) UnmarshalApplicationPolicy ¶
func (fake *MockLifecycleResource) UnmarshalApplicationPolicy(policyBytes []byte) (*common.SignaturePolicyEnvelope, string, error)
func (*MockLifecycleResource) UnmarshalApplicationPolicyArgsForCall ¶
func (fake *MockLifecycleResource) UnmarshalApplicationPolicyArgsForCall(i int) []byte
func (*MockLifecycleResource) UnmarshalApplicationPolicyCallCount ¶
func (fake *MockLifecycleResource) UnmarshalApplicationPolicyCallCount() int
func (*MockLifecycleResource) UnmarshalApplicationPolicyReturns ¶
func (fake *MockLifecycleResource) UnmarshalApplicationPolicyReturns(result1 *common.SignaturePolicyEnvelope, result2 string, result3 error)
func (*MockLifecycleResource) UnmarshalApplicationPolicyReturnsOnCall ¶
func (fake *MockLifecycleResource) UnmarshalApplicationPolicyReturnsOnCall(i int, result1 *common.SignaturePolicyEnvelope, result2 string, result3 error)
type MockTransactor ¶
type MockTransactor struct { CreateTransactionStub func(request fab.TransactionRequest) (*fab.Transaction, error) SendTransactionStub func(tx *fab.Transaction) (*fab.TransactionResponse, error) CreateTransactionHeaderStub func(opts ...fab.TxnHeaderOpt) (fab.TransactionHeader, error) SendTransactionProposalStub func(*fab.TransactionProposal, []fab.ProposalProcessor) ([]*fab.TransactionProposalResponse, error) // contains filtered or unexported fields }
func (*MockTransactor) CreateTransaction ¶
func (fake *MockTransactor) CreateTransaction(request fab.TransactionRequest) (*fab.Transaction, error)
func (*MockTransactor) CreateTransactionArgsForCall ¶
func (fake *MockTransactor) CreateTransactionArgsForCall(i int) fab.TransactionRequest
func (*MockTransactor) CreateTransactionCallCount ¶
func (fake *MockTransactor) CreateTransactionCallCount() int
func (*MockTransactor) CreateTransactionHeader ¶
func (fake *MockTransactor) CreateTransactionHeader(opts ...fab.TxnHeaderOpt) (fab.TransactionHeader, error)
func (*MockTransactor) CreateTransactionHeaderArgsForCall ¶
func (fake *MockTransactor) CreateTransactionHeaderArgsForCall(i int) []fab.TxnHeaderOpt
func (*MockTransactor) CreateTransactionHeaderCallCount ¶
func (fake *MockTransactor) CreateTransactionHeaderCallCount() int
func (*MockTransactor) CreateTransactionHeaderReturns ¶
func (fake *MockTransactor) CreateTransactionHeaderReturns(result1 fab.TransactionHeader, result2 error)
func (*MockTransactor) CreateTransactionHeaderReturnsOnCall ¶
func (fake *MockTransactor) CreateTransactionHeaderReturnsOnCall(i int, result1 fab.TransactionHeader, result2 error)
func (*MockTransactor) CreateTransactionReturns ¶
func (fake *MockTransactor) CreateTransactionReturns(result1 *fab.Transaction, result2 error)
func (*MockTransactor) CreateTransactionReturnsOnCall ¶
func (fake *MockTransactor) CreateTransactionReturnsOnCall(i int, result1 *fab.Transaction, result2 error)
func (*MockTransactor) Invocations ¶
func (fake *MockTransactor) Invocations() map[string][][]interface{}
func (*MockTransactor) SendTransaction ¶
func (fake *MockTransactor) SendTransaction(tx *fab.Transaction) (*fab.TransactionResponse, error)
func (*MockTransactor) SendTransactionArgsForCall ¶
func (fake *MockTransactor) SendTransactionArgsForCall(i int) *fab.Transaction
func (*MockTransactor) SendTransactionCallCount ¶
func (fake *MockTransactor) SendTransactionCallCount() int
func (*MockTransactor) SendTransactionProposal ¶
func (fake *MockTransactor) SendTransactionProposal(arg1 *fab.TransactionProposal, arg2 []fab.ProposalProcessor) ([]*fab.TransactionProposalResponse, error)
func (*MockTransactor) SendTransactionProposalArgsForCall ¶
func (fake *MockTransactor) SendTransactionProposalArgsForCall(i int) (*fab.TransactionProposal, []fab.ProposalProcessor)
func (*MockTransactor) SendTransactionProposalCallCount ¶
func (fake *MockTransactor) SendTransactionProposalCallCount() int
func (*MockTransactor) SendTransactionProposalReturns ¶
func (fake *MockTransactor) SendTransactionProposalReturns(result1 []*fab.TransactionProposalResponse, result2 error)
func (*MockTransactor) SendTransactionProposalReturnsOnCall ¶
func (fake *MockTransactor) SendTransactionProposalReturnsOnCall(i int, result1 []*fab.TransactionProposalResponse, result2 error)
func (*MockTransactor) SendTransactionReturns ¶
func (fake *MockTransactor) SendTransactionReturns(result1 *fab.TransactionResponse, result2 error)
func (*MockTransactor) SendTransactionReturnsOnCall ¶
func (fake *MockTransactor) SendTransactionReturnsOnCall(i int, result1 *fab.TransactionResponse, result2 error)
type RequestOption ¶
RequestOption func for each Opts argument
func WithConfigSignatures ¶
func WithConfigSignatures(signatures ...*common.ConfigSignature) RequestOption
WithConfigSignatures allows to provide pre defined signatures for resmgmt client's SaveChannel call
func WithOrderer ¶
func WithOrderer(orderer fab.Orderer) RequestOption
WithOrderer allows an orderer to be specified for the request.
func WithOrdererEndpoint ¶
func WithOrdererEndpoint(key string) RequestOption
WithOrdererEndpoint allows an orderer to be specified for the request. The orderer will be looked-up based on the key argument. key argument can be a name or url
func WithParentContext ¶
func WithParentContext(parentContext reqContext.Context) RequestOption
WithParentContext encapsulates grpc parent context.
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } clientContext, err := mockClientProvider()() if err != nil { fmt.Println("failed to return client context") return } // get parent context and cancel parentContext, cancel := sdkCtx.NewRequest(clientContext, sdkCtx.WithTimeout(20*time.Second)) defer cancel() channels, err := c.QueryChannels(WithParentContext(parentContext), WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to query for blockchain info: %s\n", err) } if channels != nil { fmt.Println("Retrieved channels that peer belongs to") }
Output: Retrieved channels that peer belongs to
func WithTargetEndpoints ¶
func WithTargetEndpoints(keys ...string) RequestOption
WithTargetEndpoints allows overriding of the target peers for the request. Targets are specified by name or URL, and the SDK will create the underlying peer objects.
func WithTargetFilter ¶
func WithTargetFilter(targetFilter fab.TargetFilter) RequestOption
WithTargetFilter enables a target filter for the request.
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } ccPolicy := policydsl.SignedByMspMember("Org1MSP") req := InstantiateCCRequest{Name: "ExampleCC", Version: "v0", Path: "path", Policy: ccPolicy} resp, err := c.InstantiateCC("mychannel", req, WithTargetFilter(&urlTargetFilter{url: "http://peer1.com"})) if err != nil { fmt.Printf("failed to install chaincode: %s\n", err) } if resp.TransactionID == "" { fmt.Println("Failed to instantiate chaincode") } fmt.Println("Chaincode instantiated")
Output: Chaincode instantiated
func WithTargets ¶
func WithTargets(targets ...fab.Peer) RequestOption
WithTargets allows overriding of the target peers for the request.
Example ¶
c, err := New(mockClientProvider()) if err != nil { fmt.Println("failed to create client") } response, err := c.QueryChannels(WithTargets(mockPeer())) if err != nil { fmt.Printf("failed to query channels: %s\n", err) } if response != nil { fmt.Println("Retrieved channels") }
Output: Retrieved channels
func WithTimeout ¶
func WithTimeout(timeoutType fab.TimeoutType, timeout time.Duration) RequestOption
WithTimeout encapsulates key value pairs of timeout type, timeout duration to Options if not provided, default timeout configuration from config will be used
type SaveChannelRequest ¶
type SaveChannelRequest struct { ChannelID string ChannelConfig io.Reader // ChannelConfig data source ChannelConfigPath string // Convenience option to use the named file as ChannelConfig reader // Users that sign channel configuration // deprecated - one entity shouldn't have access to another entities' keys to sign on their behalf SigningIdentities []msp.SigningIdentity }
SaveChannelRequest holds parameters for save channel request
type SaveChannelResponse ¶
type SaveChannelResponse struct {
TransactionID fab.TransactionID
}
SaveChannelResponse contains response parameters for save channel
type UpgradeCCRequest ¶
type UpgradeCCRequest struct { Name string Path string Version string Lang pb.ChaincodeSpec_Type Args [][]byte Policy *common.SignaturePolicyEnvelope CollConfig []*pb.CollectionConfig }
UpgradeCCRequest contains upgrade chaincode request parameters
type UpgradeCCResponse ¶
type UpgradeCCResponse struct {
TransactionID fab.TransactionID
}
UpgradeCCResponse contains response parameters for upgrade chaincode