fabric: github.com/hyperledger/fabric/core/chaincode/shim Index | Files

package shim

import "github.com/hyperledger/fabric/core/chaincode/shim"

Package shim provides APIs for the chaincode to access its state variables, transaction context and call other chaincodes.

Package shim provides APIs for the chaincode to access its state variables, transaction context and call other chaincodes.

Index

Package Files

chaincode.go handler.go inprocstream.go interfaces.go mockstub.go response.go

Constants

const (
    STATE_QUERY_RESULT resultType = iota + 1
    HISTORY_QUERY_RESULT
)
const (
    LogDebug    = LoggingLevel(logging.DEBUG)
    LogInfo     = LoggingLevel(logging.INFO)
    LogNotice   = LoggingLevel(logging.NOTICE)
    LogWarning  = LoggingLevel(logging.WARNING)
    LogError    = LoggingLevel(logging.ERROR)
    LogCritical = LoggingLevel(logging.CRITICAL)
)

These constants comprise the LoggingLevel enumeration

const (
    // OK constant - status code less than 400, endorser will endorse it.
    // OK means init or invoke successfully.
    OK  = 200

    // ERRORTHRESHOLD constant - status code greater than or equal to 400 will be considered an error and rejected by endorser.
    ERRORTHRESHOLD = 400

    // ERROR constant - default error value
    ERROR = 500
)

func Error Uses

func Error(msg string) pb.Response

func IsEnabledForLogLevel Uses

func IsEnabledForLogLevel(logLevel string) bool

IsEnabledForLogLevel checks to see if the chaincodeLogger is enabled for a specific logging level used primarily for testing

func SetLoggingLevel Uses

func SetLoggingLevel(level LoggingLevel)

SetLoggingLevel allows a Go language chaincode to set the logging level of its shim.

func SetupChaincodeLogging Uses

func SetupChaincodeLogging()

SetupChaincodeLogging sets the chaincode logging format and the level to the values of CORE_CHAINCODE_LOGFORMAT and CORE_CHAINCODE_LOGLEVEL set from core.yaml by chaincode_support.go

func Start Uses

func Start(cc Chaincode) error

chaincodes.

func StartInProc Uses

func StartInProc(env []string, args []string, cc Chaincode, recv <-chan *pb.ChaincodeMessage, send chan<- *pb.ChaincodeMessage) error

StartInProc is an entry point for system chaincodes bootstrap. It is not an API for chaincodes.

func Success Uses

func Success(payload []byte) pb.Response

type Chaincode Uses

type Chaincode interface {
    // Init is called during Instantiate transaction after the chaincode container
    // has been established for the first time, allowing the chaincode to
    // initialize its internal data
    Init(stub ChaincodeStubInterface) pb.Response

    // Invoke is called to update or query the ledger in a proposal transaction.
    // Updated state variables are not committed to the ledger until the
    // transaction is committed.
    Invoke(stub ChaincodeStubInterface) pb.Response
}

Chaincode interface must be implemented by all chaincodes. The fabric runs the transactions by calling these functions as specified.

type ChaincodeLogger Uses

type ChaincodeLogger struct {
    // contains filtered or unexported fields
}

ChaincodeLogger is an abstraction of a logging object for use by chaincodes. These objects are created by the NewLogger API.

func NewLogger Uses

func NewLogger(name string) *ChaincodeLogger

NewLogger allows a Go language chaincode to create one or more logging objects whose logs will be formatted consistently with, and temporally interleaved with the logs created by the shim interface. The logs created by this object can be distinguished from shim logs by the name provided, which will appear in the logs.

func (*ChaincodeLogger) Critical Uses

func (c *ChaincodeLogger) Critical(args ...interface{})

Critical logs always appear; They can not be disabled.

func (*ChaincodeLogger) Criticalf Uses

func (c *ChaincodeLogger) Criticalf(format string, args ...interface{})

Criticalf logs always appear; They can not be disabled.

func (*ChaincodeLogger) Debug Uses

func (c *ChaincodeLogger) Debug(args ...interface{})

Debug logs will only appear if the ChaincodeLogger LoggingLevel is set to LogDebug.

func (*ChaincodeLogger) Debugf Uses

func (c *ChaincodeLogger) Debugf(format string, args ...interface{})

Debugf logs will only appear if the ChaincodeLogger LoggingLevel is set to LogDebug.

func (*ChaincodeLogger) Error Uses

func (c *ChaincodeLogger) Error(args ...interface{})

Error logs will appear if the ChaincodeLogger LoggingLevel is set to LogError, LogWarning, LogNotice, LogInfo or LogDebug.

func (*ChaincodeLogger) Errorf Uses

func (c *ChaincodeLogger) Errorf(format string, args ...interface{})

Errorf logs will appear if the ChaincodeLogger LoggingLevel is set to LogError, LogWarning, LogNotice, LogInfo or LogDebug.

func (*ChaincodeLogger) Info Uses

func (c *ChaincodeLogger) Info(args ...interface{})

Info logs will appear if the ChaincodeLogger LoggingLevel is set to LogInfo or LogDebug.

func (*ChaincodeLogger) Infof Uses

func (c *ChaincodeLogger) Infof(format string, args ...interface{})

Infof logs will appear if the ChaincodeLogger LoggingLevel is set to LogInfo or LogDebug.

func (*ChaincodeLogger) IsEnabledFor Uses

func (c *ChaincodeLogger) IsEnabledFor(level LoggingLevel) bool

IsEnabledFor returns true if the logger is enabled to creates logs at the given logging level.

func (*ChaincodeLogger) Notice Uses

func (c *ChaincodeLogger) Notice(args ...interface{})

Notice logs will appear if the ChaincodeLogger LoggingLevel is set to LogNotice, LogInfo or LogDebug.

func (*ChaincodeLogger) Noticef Uses

func (c *ChaincodeLogger) Noticef(format string, args ...interface{})

Noticef logs will appear if the ChaincodeLogger LoggingLevel is set to LogNotice, LogInfo or LogDebug.

func (*ChaincodeLogger) SetLevel Uses

func (c *ChaincodeLogger) SetLevel(level LoggingLevel)

SetLevel sets the logging level for a chaincode logger. Note that currently the levels are actually controlled by the name given when the logger is created, so loggers should be given unique names other than "shim".

func (*ChaincodeLogger) Warning Uses

func (c *ChaincodeLogger) Warning(args ...interface{})

Warning logs will appear if the ChaincodeLogger LoggingLevel is set to LogWarning, LogNotice, LogInfo or LogDebug.

func (*ChaincodeLogger) Warningf Uses

func (c *ChaincodeLogger) Warningf(format string, args ...interface{})

Warningf logs will appear if the ChaincodeLogger LoggingLevel is set to LogWarning, LogNotice, LogInfo or LogDebug.

type ChaincodeStub Uses

type ChaincodeStub struct {
    TxID string
    // contains filtered or unexported fields
}

ChaincodeStub is an object passed to chaincode for shim side handling of APIs.

func (*ChaincodeStub) CreateCompositeKey Uses

func (stub *ChaincodeStub) CreateCompositeKey(objectType string, attributes []string) (string, error)

CreateCompositeKey documentation can be found in interfaces.go

func (*ChaincodeStub) DelState Uses

func (stub *ChaincodeStub) DelState(key string) error

DelState documentation can be found in interfaces.go

func (*ChaincodeStub) GetArgs Uses

func (stub *ChaincodeStub) GetArgs() [][]byte

GetArgs documentation can be found in interfaces.go

func (*ChaincodeStub) GetArgsSlice Uses

func (stub *ChaincodeStub) GetArgsSlice() ([]byte, error)

GetArgsSlice documentation can be found in interfaces.go

func (*ChaincodeStub) GetBinding Uses

func (stub *ChaincodeStub) GetBinding() ([]byte, error)

GetBinding documentation can be found in interfaces.go

func (*ChaincodeStub) GetCreator Uses

func (stub *ChaincodeStub) GetCreator() ([]byte, error)

GetCreator documentation can be found in interfaces.go

func (*ChaincodeStub) GetFunctionAndParameters Uses

func (stub *ChaincodeStub) GetFunctionAndParameters() (function string, params []string)

GetFunctionAndParameters documentation can be found in interfaces.go

func (*ChaincodeStub) GetHistoryForKey Uses

func (stub *ChaincodeStub) GetHistoryForKey(key string) (HistoryQueryIteratorInterface, error)

GetHistoryForKey documentation can be found in interfaces.go

func (*ChaincodeStub) GetQueryResult Uses

func (stub *ChaincodeStub) GetQueryResult(query string) (StateQueryIteratorInterface, error)

GetQueryResult documentation can be found in interfaces.go

func (*ChaincodeStub) GetSignedProposal Uses

func (stub *ChaincodeStub) GetSignedProposal() (*pb.SignedProposal, error)

GetSignedProposal documentation can be found in interfaces.go

func (*ChaincodeStub) GetState Uses

func (stub *ChaincodeStub) GetState(key string) ([]byte, error)

GetState documentation can be found in interfaces.go

func (*ChaincodeStub) GetStateByPartialCompositeKey Uses

func (stub *ChaincodeStub) GetStateByPartialCompositeKey(objectType string, attributes []string) (StateQueryIteratorInterface, error)

GetStateByPartialCompositeKey function can be invoked by a chaincode to query the state based on a given partial composite key. This function returns an iterator which can be used to iterate over all composite keys whose prefix matches the given partial composite key. This function should be used only for a partial composite key. For a full composite key, an iter with empty response would be returned.

func (*ChaincodeStub) GetStateByRange Uses

func (stub *ChaincodeStub) GetStateByRange(startKey, endKey string) (StateQueryIteratorInterface, error)

GetStateByRange documentation can be found in interfaces.go

func (*ChaincodeStub) GetStringArgs Uses

func (stub *ChaincodeStub) GetStringArgs() []string

GetStringArgs documentation can be found in interfaces.go

func (*ChaincodeStub) GetTransient Uses

func (stub *ChaincodeStub) GetTransient() (map[string][]byte, error)

GetTransient documentation can be found in interfaces.go

func (*ChaincodeStub) GetTxID Uses

func (stub *ChaincodeStub) GetTxID() string

GetTxID returns the transaction ID

func (*ChaincodeStub) GetTxTimestamp Uses

func (stub *ChaincodeStub) GetTxTimestamp() (*timestamp.Timestamp, error)

GetTxTimestamp documentation can be found in interfaces.go

func (*ChaincodeStub) InvokeChaincode Uses

func (stub *ChaincodeStub) InvokeChaincode(chaincodeName string, args [][]byte, channel string) pb.Response

InvokeChaincode documentation can be found in interfaces.go

func (*ChaincodeStub) PutState Uses

func (stub *ChaincodeStub) PutState(key string, value []byte) error

PutState documentation can be found in interfaces.go

func (*ChaincodeStub) SetEvent Uses

func (stub *ChaincodeStub) SetEvent(name string, payload []byte) error

SetEvent documentation can be found in interfaces.go

func (*ChaincodeStub) SplitCompositeKey Uses

func (stub *ChaincodeStub) SplitCompositeKey(compositeKey string) (string, []string, error)

SplitCompositeKey documentation can be found in interfaces.go

type ChaincodeStubInterface Uses

type ChaincodeStubInterface interface {
    // GetArgs returns the arguments intended for the chaincode Init and Invoke
    // as an array of byte arrays.
    GetArgs() [][]byte

    // GetStringArgs returns the arguments intended for the chaincode Init and
    // Invoke as a string array. Only use GetStringArgs if the client passes
    // arguments intended to be used as strings.
    GetStringArgs() []string

    // GetFunctionAndParameters returns the first argument as the function
    // name and the rest of the arguments as parameters in a string array.
    // Only use GetFunctionAndParameters if the client passes arguments intended
    // to be used as strings.
    GetFunctionAndParameters() (string, []string)

    // GetArgsSlice returns the arguments intended for the chaincode Init and
    // Invoke as a byte array
    GetArgsSlice() ([]byte, error)

    // GetTxID returns the tx_id of the transaction proposal (see ChannelHeader
    // in protos/common/common.proto)
    GetTxID() string

    // InvokeChaincode locally calls the specified chaincode `Invoke` using the
    // same transaction context; that is, chaincode calling chaincode doesn't
    // create a new transaction message.
    // If the called chaincode is on the same channel, it simply adds the called
    // chaincode read set and write set to the calling transaction.
    // If the called chaincode is on a different channel,
    // only the Response is returned to the calling chaincode; any PutState calls
    // from the called chaincode will not have any effect on the ledger; that is,
    // the called chaincode on a different channel will not have its read set
    // and write set applied to the transaction. Only the calling chaincode's
    // read set and write set will be applied to the transaction. Effectively
    // the called chaincode on a different channel is a `Query`, which does not
    // participate in state validation checks in subsequent commit phase.
    // If `channel` is empty, the caller's channel is assumed.
    InvokeChaincode(chaincodeName string, args [][]byte, channel string) pb.Response

    // GetState returns the value of the specified `key` from the
    // ledger. Note that GetState doesn't read data from the writeset, which
    // has not been committed to the ledger. In other words, GetState doesn't
    // consider data modified by PutState that has not been committed.
    // If the key does not exist in the state database, (nil, nil) is returned.
    GetState(key string) ([]byte, error)

    // PutState puts the specified `key` and `value` into the transaction's
    // writeset as a data-write proposal. PutState doesn't effect the ledger
    // until the transaction is validated and successfully committed.
    // Simple keys must not be an empty string and must not start with null
    // character (0x00), in order to avoid range query collisions with
    // composite keys, which internally get prefixed with 0x00 as composite
    // key namespace.
    PutState(key string, value []byte) error

    // DelState records the specified `key` to be deleted in the writeset of
    // the transaction proposal. The `key` and its value will be deleted from
    // the ledger when the transaction is validated and successfully committed.
    DelState(key string) error

    // GetStateByRange returns a range iterator over a set of keys in the
    // ledger. The iterator can be used to iterate over all keys
    // between the startKey (inclusive) and endKey (exclusive).
    // The keys are returned by the iterator in lexical order. Note
    // that startKey and endKey can be empty string, which implies unbounded range
    // query on start or end.
    // Call Close() on the returned StateQueryIteratorInterface object when done.
    // The query is re-executed during validation phase to ensure result set
    // has not changed since transaction endorsement (phantom reads detected).
    GetStateByRange(startKey, endKey string) (StateQueryIteratorInterface, error)

    // GetStateByPartialCompositeKey queries the state in the ledger based on
    // a given partial composite key. This function returns an iterator
    // which can be used to iterate over all composite keys whose prefix matches
    // the given partial composite key. The `objectType` and attributes are
    // expected to have only valid utf8 strings and should not contain
    // U+0000 (nil byte) and U+10FFFF (biggest and unallocated code point).
    // See related functions SplitCompositeKey and CreateCompositeKey.
    // Call Close() on the returned StateQueryIteratorInterface object when done.
    // The query is re-executed during validation phase to ensure result set
    // has not changed since transaction endorsement (phantom reads detected).
    GetStateByPartialCompositeKey(objectType string, keys []string) (StateQueryIteratorInterface, error)

    // CreateCompositeKey combines the given `attributes` to form a composite
    // key. The objectType and attributes are expected to have only valid utf8
    // strings and should not contain U+0000 (nil byte) and U+10FFFF
    // (biggest and unallocated code point).
    // The resulting composite key can be used as the key in PutState().
    CreateCompositeKey(objectType string, attributes []string) (string, error)

    // SplitCompositeKey splits the specified key into attributes on which the
    // composite key was formed. Composite keys found during range queries
    // or partial composite key queries can therefore be split into their
    // composite parts.
    SplitCompositeKey(compositeKey string) (string, []string, error)

    // GetQueryResult performs a "rich" query against a state database. It is
    // only supported for state databases that support rich query,
    // e.g.CouchDB. The query string is in the native syntax
    // of the underlying state database. An iterator is returned
    // which can be used to iterate (next) over the query result set.
    // The query is NOT re-executed during validation phase, phantom reads are
    // not detected. That is, other committed transactions may have added,
    // updated, or removed keys that impact the result set, and this would not
    // be detected at validation/commit time.  Applications susceptible to this
    // should therefore not use GetQueryResult as part of transactions that update
    // ledger, and should limit use to read-only chaincode operations.
    GetQueryResult(query string) (StateQueryIteratorInterface, error)

    // GetHistoryForKey returns a history of key values across time.
    // For each historic key update, the historic value and associated
    // transaction id and timestamp are returned. The timestamp is the
    // timestamp provided by the client in the proposal header.
    // GetHistoryForKey requires peer configuration
    // core.ledger.history.enableHistoryDatabase to be true.
    // The query is NOT re-executed during validation phase, phantom reads are
    // not detected. That is, other committed transactions may have updated
    // the key concurrently, impacting the result set, and this would not be
    // detected at validation/commit time. Applications susceptible to this
    // should therefore not use GetHistoryForKey as part of transactions that
    // update ledger, and should limit use to read-only chaincode operations.
    GetHistoryForKey(key string) (HistoryQueryIteratorInterface, error)

    // GetCreator returns `SignatureHeader.Creator` (e.g. an identity)
    // of the `SignedProposal`. This is the identity of the agent (or user)
    // submitting the transaction.
    GetCreator() ([]byte, error)

    // GetTransient returns the `ChaincodeProposalPayload.Transient` field.
    // It is a map that contains data (e.g. cryptographic material)
    // that might be used to implement some form of application-level
    // confidentiality. The contents of this field, as prescribed by
    // `ChaincodeProposalPayload`, are supposed to always
    // be omitted from the transaction and excluded from the ledger.
    GetTransient() (map[string][]byte, error)

    // GetBinding returns the transaction binding
    GetBinding() ([]byte, error)

    // GetSignedProposal returns the SignedProposal object, which contains all
    // data elements part of a transaction proposal.
    GetSignedProposal() (*pb.SignedProposal, error)

    // GetTxTimestamp returns the timestamp when the transaction was created. This
    // is taken from the transaction ChannelHeader, therefore it will indicate the
    // client's timestamp, and will have the same value across all endorsers.
    GetTxTimestamp() (*timestamp.Timestamp, error)

    // SetEvent allows the chaincode to propose an event on the transaction
    // proposal. If the transaction is validated and successfully committed,
    // the event will be delivered to the current event listeners.
    SetEvent(name string, payload []byte) error
}

ChaincodeStubInterface is used by deployable chaincode apps to access and modify their ledgers

type CommonIterator Uses

type CommonIterator struct {
    // contains filtered or unexported fields
}

CommonIterator documentation can be found in interfaces.go

func (*CommonIterator) Close Uses

func (iter *CommonIterator) Close() error

Close documentation can be found in interfaces.go

func (*CommonIterator) HasNext Uses

func (iter *CommonIterator) HasNext() bool

HasNext documentation can be found in interfaces.go

type CommonIteratorInterface Uses

type CommonIteratorInterface interface {
    // HasNext returns true if the range query iterator contains additional keys
    // and values.
    HasNext() bool

    // Close closes the iterator. This should be called when done
    // reading from the iterator to free up resources.
    Close() error
}

CommonIteratorInterface allows a chaincode to check whether any more result to be fetched from an iterator and close it when done.

type Handler Uses

type Handler struct {
    sync.RWMutex

    To         string
    ChatStream PeerChaincodeStream
    FSM        *fsm.FSM
    // contains filtered or unexported fields
}

Handler handler implementation for shim side of chaincode.

type HistoryQueryIterator Uses

type HistoryQueryIterator struct {
    *CommonIterator
}

HistoryQueryIterator documentation can be found in interfaces.go

func (*HistoryQueryIterator) Next Uses

func (iter *HistoryQueryIterator) Next() (*queryresult.KeyModification, error)

type HistoryQueryIteratorInterface Uses

type HistoryQueryIteratorInterface interface {
    // Inherit HasNext() and Close()
    CommonIteratorInterface

    // Next returns the next key and value in the history query iterator.
    Next() (*queryresult.KeyModification, error)
}

HistoryQueryIteratorInterface allows a chaincode to iterate over a set of key/value pairs returned by a history query.

type LoggingLevel Uses

type LoggingLevel logging.Level

LoggingLevel is an enumerated type of severity levels that control chaincode logging.

func LogLevel Uses

func LogLevel(levelString string) (LoggingLevel, error)

LogLevel converts a case-insensitive string chosen from CRITICAL, ERROR, WARNING, NOTICE, INFO or DEBUG into an element of the LoggingLevel type. In the event of errors the level returned is LogError.

type MockQueryIteratorInterface Uses

type MockQueryIteratorInterface interface {
    StateQueryIteratorInterface
}

MockQueryIteratorInterface allows a chaincode to iterate over a set of key/value pairs returned by range query. TODO: Once the execute query and history query are implemented in MockStub, we need to update this interface

type MockStateRangeQueryIterator Uses

type MockStateRangeQueryIterator struct {
    Closed   bool
    Stub     *MockStub
    StartKey string
    EndKey   string
    Current  *list.Element
}

func NewMockStateRangeQueryIterator Uses

func NewMockStateRangeQueryIterator(stub *MockStub, startKey string, endKey string) *MockStateRangeQueryIterator

func (*MockStateRangeQueryIterator) Close Uses

func (iter *MockStateRangeQueryIterator) Close() error

Close closes the range query iterator. This should be called when done reading from the iterator to free up resources.

func (*MockStateRangeQueryIterator) HasNext Uses

func (iter *MockStateRangeQueryIterator) HasNext() bool

HasNext returns true if the range query iterator contains additional keys and values.

func (*MockStateRangeQueryIterator) Next Uses

func (iter *MockStateRangeQueryIterator) Next() (*queryresult.KV, error)

Next returns the next key and value in the range query iterator.

func (*MockStateRangeQueryIterator) Print Uses

func (iter *MockStateRangeQueryIterator) Print()

type MockStub Uses

type MockStub struct {

    // A nice name that can be used for logging
    Name string

    // State keeps name value pairs
    State map[string][]byte

    // Keys stores the list of mapped values in lexical order
    Keys *list.List

    // registered list of other MockStub chaincodes that can be called from this MockStub
    Invokables map[string]*MockStub

    // stores a transaction uuid while being Invoked / Deployed
    // TODO if a chaincode uses recursion this may need to be a stack of TxIDs or possibly a reference counting map
    TxID string

    TxTimestamp *timestamp.Timestamp
    // contains filtered or unexported fields
}

MockStub is an implementation of ChaincodeStubInterface for unit testing chaincode. Use this instead of ChaincodeStub in your chaincode's unit test calls to Init or Invoke.

func NewMockStub Uses

func NewMockStub(name string, cc Chaincode) *MockStub

Constructor to initialise the internal State map

func (*MockStub) CreateCompositeKey Uses

func (stub *MockStub) CreateCompositeKey(objectType string, attributes []string) (string, error)

CreateCompositeKey combines the list of attributes to form a composite key.

func (*MockStub) DelState Uses

func (stub *MockStub) DelState(key string) error

DelState removes the specified `key` and its value from the ledger.

func (*MockStub) GetArgs Uses

func (stub *MockStub) GetArgs() [][]byte

func (*MockStub) GetArgsSlice Uses

func (stub *MockStub) GetArgsSlice() ([]byte, error)

Not implemented

func (*MockStub) GetBinding Uses

func (stub *MockStub) GetBinding() ([]byte, error)

Not implemented

func (*MockStub) GetCreator Uses

func (stub *MockStub) GetCreator() ([]byte, error)

Not implemented

func (*MockStub) GetFunctionAndParameters Uses

func (stub *MockStub) GetFunctionAndParameters() (function string, params []string)

func (*MockStub) GetHistoryForKey Uses

func (stub *MockStub) GetHistoryForKey(key string) (HistoryQueryIteratorInterface, error)

GetHistoryForKey function can be invoked by a chaincode to return a history of key values across time. GetHistoryForKey is intended to be used for read-only queries.

func (*MockStub) GetQueryResult Uses

func (stub *MockStub) GetQueryResult(query string) (StateQueryIteratorInterface, error)

GetQueryResult function can be invoked by a chaincode to perform a rich query against state database. Only supported by state database implementations that support rich query. The query string is in the syntax of the underlying state database. An iterator is returned which can be used to iterate (next) over the query result set

func (*MockStub) GetSignedProposal Uses

func (stub *MockStub) GetSignedProposal() (*pb.SignedProposal, error)

Not implemented

func (*MockStub) GetState Uses

func (stub *MockStub) GetState(key string) ([]byte, error)

GetState retrieves the value for a given key from the ledger

func (*MockStub) GetStateByPartialCompositeKey Uses

func (stub *MockStub) GetStateByPartialCompositeKey(objectType string, attributes []string) (StateQueryIteratorInterface, error)

GetStateByPartialCompositeKey function can be invoked by a chaincode to query the state based on a given partial composite key. This function returns an iterator which can be used to iterate over all composite keys whose prefix matches the given partial composite key. This function should be used only for a partial composite key. For a full composite key, an iter with empty response would be returned.

func (*MockStub) GetStateByRange Uses

func (stub *MockStub) GetStateByRange(startKey, endKey string) (StateQueryIteratorInterface, error)

func (*MockStub) GetStringArgs Uses

func (stub *MockStub) GetStringArgs() []string

func (*MockStub) GetTransient Uses

func (stub *MockStub) GetTransient() (map[string][]byte, error)

Not implemented

func (*MockStub) GetTxID Uses

func (stub *MockStub) GetTxID() string

func (*MockStub) GetTxTimestamp Uses

func (stub *MockStub) GetTxTimestamp() (*timestamp.Timestamp, error)

func (*MockStub) InvokeChaincode Uses

func (stub *MockStub) InvokeChaincode(chaincodeName string, args [][]byte, channel string) pb.Response

InvokeChaincode calls a peered chaincode. E.g. stub1.InvokeChaincode("stub2Hash", funcArgs, channel) Before calling this make sure to create another MockStub stub2, call stub2.MockInit(uuid, func, args) and register it with stub1 by calling stub1.MockPeerChaincode("stub2Hash", stub2)

func (*MockStub) MockInit Uses

func (stub *MockStub) MockInit(uuid string, args [][]byte) pb.Response

Initialise this chaincode, also starts and ends a transaction.

func (*MockStub) MockInvoke Uses

func (stub *MockStub) MockInvoke(uuid string, args [][]byte) pb.Response

Invoke this chaincode, also starts and ends a transaction.

func (*MockStub) MockInvokeWithSignedProposal Uses

func (stub *MockStub) MockInvokeWithSignedProposal(uuid string, args [][]byte, sp *pb.SignedProposal) pb.Response

Invoke this chaincode, also starts and ends a transaction.

func (*MockStub) MockPeerChaincode Uses

func (stub *MockStub) MockPeerChaincode(invokableChaincodeName string, otherStub *MockStub)

Register a peer chaincode with this MockStub invokableChaincodeName is the name or hash of the peer otherStub is a MockStub of the peer, already intialised

func (*MockStub) MockTransactionEnd Uses

func (stub *MockStub) MockTransactionEnd(uuid string)

End a mocked transaction, clearing the UUID.

func (*MockStub) MockTransactionStart Uses

func (stub *MockStub) MockTransactionStart(txid string)

Used to indicate to a chaincode that it is part of a transaction. This is important when chaincodes invoke each other. MockStub doesn't support concurrent transactions at present.

func (*MockStub) PutState Uses

func (stub *MockStub) PutState(key string, value []byte) error

PutState writes the specified `value` and `key` into the ledger.

func (*MockStub) SetEvent Uses

func (stub *MockStub) SetEvent(name string, payload []byte) error

Not implemented

func (*MockStub) SplitCompositeKey Uses

func (stub *MockStub) SplitCompositeKey(compositeKey string) (string, []string, error)

SplitCompositeKey splits the composite key into attributes on which the composite key was formed.

type PeerChaincodeStream Uses

type PeerChaincodeStream interface {
    Send(*pb.ChaincodeMessage) error
    Recv() (*pb.ChaincodeMessage, error)
    CloseSend() error
}

PeerChaincodeStream interface for stream between Peer and chaincode instance.

type StateQueryIterator Uses

type StateQueryIterator struct {
    *CommonIterator
}

StateQueryIterator documentation can be found in interfaces.go

func (*StateQueryIterator) Next Uses

func (iter *StateQueryIterator) Next() (*queryresult.KV, error)

type StateQueryIteratorInterface Uses

type StateQueryIteratorInterface interface {
    // Inherit HasNext() and Close()
    CommonIteratorInterface

    // Next returns the next key and value in the range and execute query iterator.
    Next() (*queryresult.KV, error)
}

StateQueryIteratorInterface allows a chaincode to iterate over a set of key/value pairs returned by range and execute query.

Package shim imports 24 packages (graph) and is imported by 407 packages. Updated 2017-12-11. Refresh now. Tools for package owners.