Step-by-Step Tutorials

Canis Major Configuration Overview

Ethereum Transaction using AEI Contract

AEI Contract is written in Solidity using ERC721 standard (NFT) and can be use with Ethereum Clients. It is compatible with FIWARE-Canis Major Adaptor to store the data in blockchain. AEI, asset, events (metadata), relationship, is designed to store the NGSI-LD model with the help of Canis Major Adaptor.

• Storage Type: IOTAMaM (Masked Authenticated Messaging)

(make sure you remote previous docker contrainers, use the docker commands mentioned above)

Step 1: Clone the repository

https://github.com/FIWARE-Blockchain/tutorials.Step-by-Step.git
cd tutorials.Step-by-Step
sh clean.sh (docker clean up)

Step 2: Build and run the aei-contract and rpc network

(you can use ganache-cli, besu, parity or any other client)

docker-compose -f eth-aei.yml up --build

once the service start it will deploy the contracts. Get the contract address from the terminal to use in step 3.

Step 3: Running the Services

(mention the contract address)

CONTRACT_ADDRESS=${CONTRACT_ADDRESS} docker-compose -f eth-aei-iotaMaM-service.yml up --build

Step 4:Import Postman Collection

Import postman collection to learn the service. POSTMAN Collection

• Storage Type: IPFS (InterPlanetary File System)

(make sure you remote previous docker contrainers, use the docker commands mentioned above)

Step 1: Clone the repository

https://github.com/FIWARE-Blockchain/tutorials.Step-by-Step.git
cd tutorials.Step-by-Step
sh clean.sh (docker clean up)

Step 2: Build and run the aei-contract and rpc network

(you can use ganache-cli, besu, parity or any other client)

docker-compose -f eth-aei.yml up --build

once the service start it will deploy the contracts. Get the contract address from the terminal to use in step 3.

Step 3: Running the Services

(mention the contract address)

CONTRACT_ADDRESS=${CONTRACT_ADDRESS} docker-compose -f eth-aei-IPFS-service.yml up --build

Step 4:Import Postman Collection

Import postman collection to learn the service. POSTMAN Collection

• Storage Type: Merkle Tree

(make sure you remote previous docker contrainers, use the docker commands mentioned above)

Step 1: Clone the repository

https://github.com/FIWARE-Blockchain/tutorials.Step-by-Step.git
cd tutorials.Step-by-Step
sh clean.sh (docker clean up)

Step 2: Build and run the aei-contract and rpc network

(you can use ganache-cli, besu, parity or any other client)

docker-compose -f eth-aei.yml up --build

once the service start it will deploy the contracts. Get the contract address from the terminal to use in step 3.

Step 3: Running the Services

(mention the contract address)

CONTRACT_ADDRESS=${CONTRACT_ADDRESS} docker-compose -f eth-aei-merkle-service.yml up --build

Step 4:Import Postman Collection

Import postman collection to learn the service. POSTMAN Collection

Ethereum Transaction using Your Own Contract

You can also use Canis Major Adaptor for your own Smart Contract (currently adaptor support eth_sendRawTransaction and no read options, but in future this features will be added)

Step 1: Clone the repository

(make sure you remote previous docker contrainers, use the docker commands mentioned above)

https://github.com/FIWARE-Blockchain/tutorials.Step-by-Step.git
cd tutorials.Step-by-Step
sh clean.sh (docker clean up)

Step 2: Build and run the aei-contract and rpc network

(you can use eth other client which support eth_sendRawTransaction)

docker-compose -f eth-other-service.yml up --build

once the service start it will deploy the contracts. Get the contract address from the terminal to use in step 3.

Step 3: Running the Services

(mention the contract address)

CONTRACT_ADDRESS=${CONTRACT_ADDRESS} docker-compose -f eth-other-service.yml up --build

Step 4:Import Postman Collection

Import postman collection to learn the service. POSTMAN Collection

IOTA Transaction

Canis Major also support transaction for IOTA (v1.0 mainnet, not 1.5 Hornet)

Step 1: Clone the repository

(make sure you remote previous docker contrainers, use the docker commands mentioned above)

https://github.com/FIWARE-Blockchain/tutorials.Step-by-Step.git
cd tutorials.Step-by-Step
sh clean.sh (docker clean up)

Step 2: Running the Services

docker-compose -f iota.yml up --build

Step 3:Import Postman Collection

Import postman collection to learn the service. POSTMAN Collection

Docker clean up command

// stop all container
docker stop $(docker ps -a -q)

// remove all container
docker rm $(docker ps -a -q)

// delete all volumes
docker volume prune

// delete all networks
docker network prune

// delete all images
docker rmi $(docker images -a -q)

© 2021 FIWARE Foundation e.V.