Request Network storage layer based on ethereum.
npm install @requestnetwork/ethereum-storage@requestnetwork/ethereum-storage is a package part of the Request Network protocol.
It is an implementation of the Storage layer of Request Network protocol that uses IPFS to immutably store the data and uses the Ethereum network to persist the IPFS hash of the data and make them permanently available to everyone.
To use Infura to connect to an Ethereum node, get an Infura token on infura.io and
use as provider "NETWORK_YOU_WANT.infura.io/v3/YOUR_INFURA_TOKEN".
``bash`
npm install @requestnetwork/ethereum-storage
`js
import {
EthereumStorage,
EthereumTransactionSubmitter,
IpfsStorage,
} from '@requestnetwork/ethereum-storage';
const ethereumStorage = new EthereumStorage({
ipfsStorage: new IpfsStorage(),
txSubmitter: new EthereumTransactionSubmitter(),
});
const data = 'Some data';
await ethereumStorage.append(data);
`
The gas limit defined as safeGasPriceLimit in /src/config.ts can be overridden with the environment variable GAS_PRICE_DEFAULT.
ethereum-storage uses smart contracts to store IPFS hashes.
The smart contracts can be downloaded in order to deploy them on a local environment:
`bash`
git clone https://github.com/RequestNetwork/requestNetwork.git
cd requestNetwork/packages/smart-contracts
yarn install
yarn run build
yarn run ganache
And in another terminal:
`bash`
yarn run deploy
There are 3 smart contracts:
- RequestHashStorage allows to declare a hash NewHash(hash, submitter, feesParameters). Only a whitelisted contract can declare hashes.RequestOpenHashSubmitter
- entry point to add hashes in RequestHashStorage. It gives the rules to get the right to submit hashes and collect the fees. This contract must be whitelisted in RequestHashStorage. The only condition for adding hash is to pay the fees.StorageFeeCollector
- parent contract (not deployed) of RequestOpenHashSubmitter, computes the fees and send them to the burner.
#### Configuring the provider using Truffle and the development network
When deploying the smart contracts for development you can manually set the provider host and port via env variables:
`bash`
TRUFFLE_GANACHE_HOST="host" TRUFFLE_GANACHE_PORT=1010 yarn run deploy
In order to use the package in a test environment, IPFS should be running locally.
Local IPFS listening on port 5001 is used by default by the ethereum-storage package.
Request uses an IPFS private network to allow all nodes to connect to each other directly,
instead of having to navigate through the public IPFS network.
You may use the Request IPFS docker image to setup your IPFS node to the private network. Make sure that docker is installed on your system and then run the following command:
`bash``
docker run -p 4001:4001 -p 5001:5001 requestnetwork/request-ipfs
This will pull the request-ipfs docker image and run it locally.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Read the contributing guide