https://github.com/semtexzv/ipcs

Inter-planetary Computation System
https://github.com/semtexzv/ipcs

Last synced: 2 days ago
JSON representation

Inter-planetary Computation System

• Host: GitHub
• URL: https://github.com/semtexzv/ipcs
• Owner: semtexzv
• Created: 2020-07-24T20:50:25.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-07-23T04:49:27.000Z (over 3 years ago)
• Last Synced: 2024-10-31T11:45:04.108Z (9 days ago)
• Language: Rust
• Size: 79.1 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# InterPlanetary Computation System

Is a peer-to-peer system for performing distributed computations. 

## How ?

The system uses WebAssembly to create portable, sandboxed binaries which have minimal interface, and uses IPFS 

to store the these binaries and data on which they operate in order to create perfectly secure computing environment.

It uses p2p communication between nodes in order to distribute the work of running individual functions between

multiple nodes.

## How to use this  ?

`cargo install ipcs-cli` and then use the `ipcs` command.

You can either start a node using `ipcs node` command (NOTE: Requires running IPFS deamon).

Or execute functions using `ipcs exec` agains the local node (NOTE: The node against which requests are submitted

does not execute functions, for debugging purposes it forcibly distributes them to connected peers).

```bash

ipcs node # Runs local API+worker node

ipcs node -n # Runs node without API, making it only a worker

ipcs exec QmT8MRDQxey9PVBWVRZCBDgXSg3mSQJ3a9y88pC8rAuNdz QmeMk2xH5DMpqumNn9F7vTYTgx51kSkso9WkQv35Gnn74D

# Runs QmT8MRDQxey9PVBWVRZCBDgXSg3mSQJ3a9y88pC8rAuNdz function on data in QmeMk2xH5DMpqumNn9F7vTYTgx51kSkso9WkQv35Gnn74D

```

### How to create new functions ?

Check out examples. There is a simple [ipcs-runtime](https://crates.io/crates/ipcs-runtime) crate for creating rust

functions (Note: functions need to be compiled using the `wasm32-unknown-unknown` target)

Then upload these functions using 

`ipfs add ./target/debug/.wasm`

Upon uploading the function, you will be presented with ID of IPFS object, which contains function data, and can be used 

to execute the function