mirror of
https://github.com/hyperledger/fabric-samples.git
synced 2026-06-17 15:35:09 +00:00
bee24a7615
Also: - Refactor application-gateway-java slightly to reflect more idiomatic Java class structure, in line with asset-transfer-events sample. - Correctly handle unexpected error case where key file is missing. - Update Gradle wrapper for application-gateway-java. Signed-off-by: Mark S. Lewis <mark_lewis@uk.ibm.com>
78 lines
No EOL
2.8 KiB
Markdown
78 lines
No EOL
2.8 KiB
Markdown
# Asset transfer basic sample
|
|
|
|
The asset transfer basic sample demonstrates:
|
|
|
|
- Connecting a client application to a Fabric blockchain network.
|
|
- Submitting smart contract transactions to update ledger state.
|
|
- Evaluating smart contract transactions to query ledger state.
|
|
- Handling errors in transaction invocation.
|
|
|
|
## About the sample
|
|
|
|
This sample includes smart contract and application code in multiple languages. This sample shows create, read, update, transfer and delete of an asset.
|
|
|
|
For a more detailed walk-through of the application code and client API usage, refer to the [Running a Fabric Application tutorial](https://hyperledger-fabric.readthedocs.io/en/latest/write_first_app.html) in the main Hyperledger Fabric documentation.
|
|
|
|
### Application
|
|
|
|
Follow the execution flow in the client application code, and corresponding output on running the application. Pay attention to the sequence of:
|
|
|
|
- Transaction invocations (console output like "**--> Submit Transaction**" and "**--> Evaluate Transaction**").
|
|
- Results returned by transactions (console output like "**\*\*\* Result**").
|
|
|
|
### Smart Contract
|
|
|
|
The smart contract (in folder `chaincode-xyz`) implements the following functions to support the application:
|
|
|
|
- CreateAsset
|
|
- ReadAsset
|
|
- UpdateAsset
|
|
- DeleteAsset
|
|
- TransferAsset
|
|
|
|
Note that the asset transfer implemented by the smart contract is a simplified scenario, without ownership validation, meant only to demonstrate how to invoke transactions.
|
|
|
|
## Running the sample
|
|
|
|
The Fabric test network is used to deploy and run this sample. Follow these steps in order:
|
|
|
|
1. Create the test network and a channel (from the `test-network` folder).
|
|
```
|
|
./network.sh up createChannel -c mychannel -ca
|
|
```
|
|
|
|
1. Deploy one of the smart contract implementations (from the `test-network` folder).
|
|
```
|
|
# To deploy the TypeScript chaincode implementation
|
|
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-typescript/ -ccl typescript
|
|
|
|
# To deploy the Go chaincode implementation
|
|
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go/ -ccl go
|
|
|
|
# To deploy the Java chaincode implementation
|
|
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-java/ -ccl java
|
|
```
|
|
|
|
1. Run the application (from the `asset-transfer-basic` folder).
|
|
```
|
|
# To run the Typescript sample application
|
|
cd application-gateway-typescript
|
|
npm install
|
|
npm start
|
|
|
|
# To run the Go sample application
|
|
cd application-gateway-go
|
|
go run .
|
|
|
|
# To run the Java sample application
|
|
cd application-gateway-java
|
|
./gradlew run
|
|
```
|
|
|
|
## Clean up
|
|
|
|
When you are finished, you can bring down the test network (from the `test-network` folder). The command will remove all the nodes of the test network, and delete any ledger data that you created.
|
|
|
|
```
|
|
./network.sh down
|
|
``` |