Download react native fula - react native fula

React-native-fula

Este pacote é uma ponte para usar os protocolos FULA na nativa do React. Ele usa o WNFS para criar o Merkle DAG a partir de arquivos e pastas e transferir o DAG usando o GraphSync para os nós.

Instalação

npm install react-native-fula

Uso

 import { fula } from 'react-native-fula' ; // Until the library becomes stable, we suggest importing from github directly

 // Creates a new client without creating a filesystem. It is better to call this instead of directly calling init
const peerId //returns peerId as string
=  newClient (
  identity : string , //privateKey of did identity
  storePath : string , // leave empty to use the default temp one
  bloxAddr : string , //leave empty for testing without a backend node
  exchange : 'noop' | '' , //add noop for testing without a backend
  autoFlush : boolean , //Default to false. Always set to false unless you know what you are doing. explicitly write data to disk after each operation if set to true
  useRelay : boolean , //default to true. If true it forces the connection through relay
  refresh : boolean ? //forces the fula object to be recreated. default is false
)

 //Initialize the fula client, which creates the libp2p connection if newClient is not called before, and creates filesystem. Note that input is not an object e.g. init('','','','noop', false)
[
    peerId , //returns peerId of the created libp2p instance in form of a string of bytes
    cid , //return the root cid of the WNFS merkle DAG in form of a string
    private_ref //return the keys needed to decode hte encrypted WNFS tree in form of a string of object
]
=
await fula . init (
    identity : string , //bytes of the privateKey of did identity in string format
    storePath : string , // leave empty to use the default temp one
    bloxAddr : string , //leave empty for testing without a backend node
    exchange : 'noop' | '' , //add noop for testing without a backend
    autoFlush : boolean , //Default to false. Always set to false unless you know what you are doing. explicitly write data to disk after each operation if set to true
    useRelay : boolean , //default to true. If true it forces the connection through relay
    refresh : boolean ? //forces the fula object to be recreated. default is false
) ;

 //Creates a Folder
const cid //returns the cid of the new root. Note that on every write action the root cid changes.
=
await fula . mkdir (
    path : string // This is the Fula path to create a folder and always starts with "root/" and should not start or end with a slash e.g "root/pictures"
) ;

 //Write a local file on the device to the Fula tree (upload). It keeps the original file modification date.
const cid //returns the cid of the new root. Note that on every write action the root cid changes.
=
await fula . writeFile (
    fulaTargetFilename : string , //path to the file on the tree. It should include the filename and extension and start from the "root/". e.g. "root/pictures/cat.jpg"
    localFilename : string //path to the local file. e.g the file that needs to be uploaded
) ;
//// TODO: This needs to be improved by using stream to not overload the memory for large files

 //reads a file on fula tree to a local file on the device (download). It is stream so does not affect memory for large files.
const localFilePath //returns the path to the local file and includes the filename
=
await fula . readFile (
    fulaTargetFilename : string , //path to the file on the tree. It should include the filename and extension and start from the "root/". e.g. "root/pictures/cat.jpg"
    localFilename : string //path to the local file. It should include the filename and extension. e.g. "/temp/cat.jpg"
) ;

 //shows all files and folders under the specified path on Fula
const fileList //returns all the files and folders in a string separated by n
=
await fula . ls (
    path : string , //path to the folder on the tree. It always starts from the "root". e.g. "root" or "root/pictures"
) ;
//// TODO: This needs to be improved by returning an array of files and folders and in chunks to not overload hte memory for large folders

 //removes all files and folders at the specified path on Fula
const cid //returns the cid of the new root. Note that on every write action the root cid changes.
=
await fula . rm (
    path : string , //path to the file or folder on the tree. It always starts from the "root". e.g. "root/pictures" or "root/pictures/cat.jpg"
) ;

 //copies the specified file or folder at sourcePath to the filename at targetPath. the path itself(apart from filename) must exist
const cid //returns the cid of the new root. Note that on every write action the root cid changes.
=
await fula . cp (
    sourcePath : string , //path to the file or folder on the tree. It always starts from the "root". e.g. "root/pictures" or "root/pictures/cat.jpg"
    targetPath : string , //path to the file or folder on the tree. It always starts from the "root". e.g. "root/pictures2" or "root/pictures2/cat.jpg"
) ;

 //moves the specified file or folder at sourcePath to the filename at targetPath. the path itself(apart from filename) must exist
const cid //returns the cid of the new root. Note that on every write action the root cid changes.
=
await fula . mv (
    sourcePath : string , //path to the file or folder on the tree. It always starts from the "root". e.g. "root/pictures" or "root/pictures/cat.jpg"
    targetPath : string , //path to the file or folder on the tree. It always starts from the "root". e.g. "root/pictures2" or "root/pictures2/cat.jpg"
) ;

 //checks if fula is ready (initialized through newClient or init)
const result //returns true if succesful and false if fails
=
await fula . isReady (
    filesystemCheck : boolean //Default is true. If true it checks if both WNFS and Fula are ready. If false it only checks fula
) ;

 //checks if client can reach server
const result //returns true if it can, and false if it cannot
=
await fula . checkConnection (
    timeout : number ? //default to 20. Maximum time in seconds that checkConnection waits before throwing an error
) ;

 //checks if there are any un-synced actions on the client
const result //returns true if there are, and false if everything is synced with server
=
await fula . checkFailedActions (
    retry : boolean //if true, it tries to sync device with server, if not, it only checks
    timeout : number ? //default to 20. Maximum time in seconds that checkConnection waits before throwing an error
) ;

 //lists any cids that are failed to be pushed to backend and only exist on client device
const result //returns an array of cids or false if no cid is found
=
await fula . listFailedActions (
    cids : string [ ] //if [], it returns all failed cids, and if provided, it only return the failed cids that are in the array of cids provided as input
) ;

 //Gives access to the blox for a specific peerId. This call must be made from the authorizer only.
const result //returns true if succesful and false if fails
=
await fula . setAuth (
    peerId : string , //peer ID of the app that needs access to the blox
    allow : boolean , // true to allow and false to remove access
) ;

 //shuts down the fula libp2p and datastore
await fula . shutdown ( ) ;

 //removes all Fula related data and information (Except the encrypted filesystem) at the specified storage local path
const result //returns true if succesful and false if fails
=
await fula . logout (
    identity : string , //bytes of the privateKey of did identity in string format
    storePath : string , // leave empty to use the default temp one
) ;

Criação do tipo Polkadot

Você pode seguir a documentação aqui: https://polkadot.js.org/docs/api/examples/promise/typegen

Como alternativa, você faz o abaixo em um Linux ou WSL dentro da pasta React-native-Fula:

curl -H " Content-Type: application/json " -d " { " id " : " 1 " , " jsonrpc " : " 2.0 " , " method " : " state_getMetadata " , " params " :[]} " https://node3.functionyard.fula.network > edgeware.json

yarn build:polkadot

Teste

Abra um CMD ou Terminal como Admin (Sudo)

 corepack enable

Em seguida, CD para a pasta react-native-fula (sem necessidade de admin, sudo) e execute:

 yarn install

Para executar o aplicativo de exemplo, execute:

 yarn example android

Roteiro

Observe que o seguinte pode não ser feito em ordem:

Versão inicial com todas as funções incluídas
Adicione a geração de chave de criptografia de árvore WNFS a partir de uma entrada (deterministicamente)
Melhore a função EAD para usar um fluxo. (? Lançamento v1 aqui)
Conecte -se ao back -end
Conecte -se aos códigos de blockchain usando APIs

Outras bibliotecas relacionadas

Nome	Descrição
WNFs para Android	Android Build for WNFS Rust Version
WNFs para iOS	iOS Build for WNFS Rust Version
WNFS Build	Android .AAR para WNFS
Fula Build	Android .AAR Arquivo para Fula
FX Fotos	FX Fotos Dapp usando react-native-fula