mirror of https://github.com/hyperledger/fabric-samples.git synced 2026-06-17 07:25:10 +00:00

History

Mark S. Lewis b931df3a5f Explicitly specify hash in client applications For some signing implementations, such as ed25519, a non-default hash implementation must be specified when creating the Gateway connection in client applications. Rather than relying on the default hash algorithm, it is probably good practice in general to specify an algorithm that is compatible with your signing implementation. This change explicitly specifies the hash algorithm to raise visibility of the option to select the hash algorithm. Signed-off-by: Mark S. Lewis <Mark.S.Lewis@outlook.com>		2024-10-07 12:25:40 -04:00
..
application-gateway-go	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
application-gateway-java	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
application-gateway-javascript	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
application-gateway-typescript	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
chaincode-external	Fix directory path for chaincode-external	2024-06-24 16:27:16 -04:00
chaincode-go	Update Go chaincode to fabric-contract-api-go/v2	2024-06-21 15:18:12 -04:00
chaincode-java	Update test dependencies for Java chaincode	2024-05-21 22:19:39 -04:00
chaincode-javascript	Use more specific chaincode package versions	2024-06-14 00:24:08 -04:00
chaincode-typescript	Update TypeScript implementations	2024-06-18 06:51:58 -04:00
rest-api-go	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
rest-api-typescript	Update TypeScript implementations	2024-06-18 06:51:58 -04:00
.gitignore	Adding NodeJS app for asset-transfer-basic sample. (#206 )	2020-06-30 15:36:47 -04:00
README.md	Add JavaScript asset-transfer-basic application	2024-06-21 12:16:31 -04:00

README.md

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 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:

Create the test network and a channel (from the test-network folder).
```
./network.sh up createChannel -c mychannel -ca
```

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 JavaScript chaincode implementation:

./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-javascript/ -ccl javascript

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

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 JavaScript sample application:
```
cd application-gateway-javascript
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